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数字 版权 声 明 


图 灵 社 区 的 电子 书 没有 采用 专 有 客 
户 端 ， 您 可 以 在 任意 设备 上 ， 本 
己 喜 欢 的 浏览 器 和 PDF 阅读 器 进 
阅读 。 

但 您 购买 的 电子 书 仅 供 您 个 人 使 
用 ， 未 经 授权 ， 不 得 进行 传播 。 
我 们 愿意 相信 读者 具有 这 样 的 民 知 
和 咒 悟 ， 与 我 们 共同 保护 知识 产 
权 。 

如 果 购 买 者 有 侵权 行为 ， 我 们 可 能 
对 该 用 户 实 施 包 括 但 不 限于 关闭 该 
帐号 等 维权 措施 ， 并 可 能 退 究 法 律 
责任 。 


Mike Cantelon 
Node.js 核 心 框架 贡献 者 、Node 社 区 活跃 分 
子 、 资 深 培 训 师 和 演讲 人 。 


Marc Harter 
Node.js 核 心 框架 贡献 者 。 


T. J. Holowaychuk 


参与 开发 了 很 多 Node.js 模 块 ， 包 括 流行 的 
Express 框 架 。 


Nathan Rajlich 
大 名 见 昂 的 TooTallINate，Node.js 核 心 代 码 


是 交 者 。 
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吴 海 星 
2001 年 毕业 于 南京 理工 大 学 。 编 程 数 载 代 码 
不 过 几 十 万 ， 翻 译 几 年 码 字 不 过 几 百 万 。 项 
目 不 过 十 几 个 ， 带 队 不 到 五 十 人 。 年 过 而 
立 ， 悄 悄 不 安 ， 傅 加 发 奋 ， 孜 孜 求学 ， 愿 赁 
绵薄 之 力 ， 贡 献 于 IT 社区 。 
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内 容 提 要 
本 书 是 Node.js 的 实战 教程 ,涵盖 了 为 开发 产品 级 Node 应 用 程序 所 需要 的 一 切 特 性 、 技 巧 以 及 相关 理念 。 
从 搭建 Node 开发 环境 ， 到 一 些 简 单 的 演示 程序 ， 到 开发 复杂 应 用 程序 所 必 不 可 少 的 异步 编程 。 书 中 还 介绍 
了 HTTP API 的 应 用 技巧 等 。 
本 书 适 合 Web 开发 人 员 阅 读 。 
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版 权 声 明 


Original English language edition, entitled Node.js in Action by Mike Cantelon, Marc Harter, 工 .J. 
Holowaychuk, Nathan Rajlich, published by Manning Publications. 178 South Hill Drive, Westampton, 
NJ 08060 USA. Copyright © 2014 by Manning Publications. 

Simplified Chinese-language edition copyright © 2014 by Posts & Telecom Press. All rights reserved. 





本 书 中 文 简体 字 版 由 Manning Publications 授 权 人 民 邮 电 出 版 社 独家 出 版 。 未 经 出 版 者 书面 许 
可 ,不 得 以 任何 方式 复制 或 抄 欠 本 书 内 容 。 
版 权 所 有 ， 侵 权 必 究 。 
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友 


写 一 本 关于 Node.js 的 书 是 一 项 很 有 挑战 性 的 任务 。 这 是 一 个 相对 新 的 平台 , 最 近 才 刚刚 趋 于 
稳定 。Node.js 的 核心 一 直 在 进化 ， 并 且 社 区 中 由 用 户 创建 的 模块 数量 也 呈现 出 了 爆炸 性 的 增长 ， 
其 发 展 速 度 没 人 能 跟 得 上 。 社区 也 仍然 在 找寻 上 自己 的 声 首 。 写 书 曾 释 这 样 一 个 还 在 不 断 发 展 的 主 
点 ， 唯 一 的 办 法 是 理解 Node 的 本 质 ， 以 及 它 为 什么 这 样 成 功 。 这 些 Node.js 老 兵 们 就 是 这 么 做 的 。 
Mike Cantelon 在 Node 社 区 中 极其 活跃 ， 用 Node 做 实验 ， 谈论 Node。 关 于 Node 适 合 做 什么 可 
能 更 重要 的 是 不 适合 做 什么 ， 他 有 着 极 深 的 洞 见 。 工 J. Holowaychuk 是 最 多 产 的 Node.js 模 块 作 者 
之 一 ， 其 中 包括 大 规模 流行 的 Web 框 架 Express。Nathan Rajlich， 也 就 是 著名 的 TooTallNate, 已 
经 做 了 一 段 时 间 的 Node.js 核 心 代码 的 提交 者 ， 他 也 是 平台 发 展 到 当前 这 种 成 玖 状 态 的 积极 推动 
力量 。 

本 书 吸 取 了 他 们 丰富 的 经 验 , 市 着 你 从 最 初 的 Node.js 安 装 ， 到 创建 应 用 、 调 试 程 序 和 部 署 产 
品 ， 一 路 走 下 去 。 你 将 了 解 到 是 什么 让 Node 如 此 有 趣 ， 并 从 中 笑 见 各 位 作者 的 理解 ， 这 样 Node 
项 目 将 来 的 发 展 方 回 也 变 得 更 好 理解 了 。 最 重要 的 是 ,本 书 内 容 由 浅 和 人 人 次、 循序 淋 进 ， 每 一 阶段 
都 以 之 前 所 学 的 内 容 为 基础 。 

Node 是 一 个 正在 升 起 的 火箭 , 作者 们 成 功 地 将 你 带 上 了 这 一 旅程 。 请 将 本 书 作为 跳板 ， 从 这 
里 出 发 ， 开 折 你 目 己 的 视野 吧 。 












































Isaac Z. Schlueter 
Node 包 管理 器 ( NPM ) 作者 
Node.js 项 目 负责 人 
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2011 年 初 ，Manning 出 版 社 找到 我 们 ， 说 想 出 一 本 关于 Node.js 的 书 ， 那 时 Node 社 区 的 状态 和 
现在 很 不 一 样 , 圈子 还 很 小 。 尺 管 已 经 有 很 多 人 表现 出 了 对 它 的 兴趣 , 但 Node 仍 然 被 主流 开发 社 
区 看 做 是 一 项 有 风险 的 技术 , 还 没有 人 写 过 关于 Node 的 书 。 尽 管 写 书 的 想法 令 人 生 旦 , 但 我 们 还 
是 决定 去 大 胆 一 试 。 

鉴于 我 们 各 自 的 开发 方 回 不 同 ， 我 们 想 不 仅 要 把 这 本 书 的 重点 全 放 在 Node 的 Web 程 序 开 发 
上 ,还 还 要 探索 其 他 有 趣 的 潜在 有 用途。 我 们 想 给 Web 开 发 人 员 指 出 一 条 道路 ， 用 现 有 技术 将 异步 开 
发 市 人 服务 需 这 一 Node 愿 景 。 

这 本 书 我 们 写 了 两 年 多 , 在 写作 过 程 中 , 这 门 技术 已 经 进化 了 , 所 以 我 们 也 相应 地 做 了 更 新 。 

它 现 在 变 得 更 大 了 ， 很 多 成 熟 的 公司 也 开始 拥抱 Node。 

对 于 想 做 些 不 同 尝 试 的 Web 程 序 开发 人 员 , 现在 是 学 习 Node 的 好 时 机 , 希望 这 本 书 可 以 帮 到 

你 ， 让 你 能 迅速 学 会 这 门 技术 ， 并 在 其 中 找到 乐趣 。 
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致谢 


感谢 Manning 出 版 社 那 些 优秀 的 人 们 在 本 书 出 版 过 程 中 所 发 挥 的 作用 。Renae Gregoire 在 其 中 
扮演 了 重要 角色 ， 在 他 的 督促 下 ， 我 们 才能 写 出 雄辩 、 清 晰 、 高 品质 的 内 容 。Bert Bates 帮 助 定 
义 了 本 书 的 视觉 感受 ， 跟 我 们 一 起 设计 了 书 中 的 各 种 图 形 来 表示 不 同 的 概念 。Marjan Bace 和 
Michael Stephens 给 予 了 我 们 充分 的 信任 ， 委 托 我 们 来 写 这 本 书 ， 并 协助 推动 项 目前 行 。 还 有 
Manning 出 版 社 的 编辑 、 生 产 和 技术 职员 们 ， 我 们 合作 得 非常 愉快 。 

在 成 书 的 各 个 阶段 , 很 多 人 参与 了 书稿 的 评审 工作 , 我 们 也 要 对 他 们 的 反馈 表示 感谢 。 包 括 
在 本 书 的 在 线 论 坛 中 发 表 评 论 及 指出 书 中 错误 的 MEAP 读 者 ， 还 有 下 面 这 些 评审 者 ， 他 们 多 次 阅 
读书 稿 ， 其 见解 和 评论 让 本 书 变 得 更 好 ， 他 们 是 : Alex Madurell、Bert Thomas 、Bradley Meck、 
Braj Panda、 Brian L. Cooley、 Brian Del Vecchio、 Brian Dillard、Brian Ehmann、Brian Falk、Daniel 
































Bretol、 Gary Ewan Park、 Jeremy Martin、Jeroen Nouws、 Jeroen Trap pers、 Kassandra Perch、 Kevin 
Baister、 Michael Piscatello、Patrick Steger、Paul Stack 和 Scott Banachowski。 

还 要 感谢 Valentin Crettaz 和 Michael Levin， 就 在 这 本 书 即 将 出 版 之 前 ， 他 们 对 最 终 书 稿 做 了 
认真 的 技术 校对 。 最 后 同样 重要 的 ， 我 们 还 要 感谢 Node 项 目的 负责 人 Isaac Schlueter 为 本 书 作 序 。 








MIKE CANTELON 的 致谢 


我 要 感谢 我 的 朋友 Joshua Paul， 他 将 我 斋 和 人 开源 的 世界 ， 给 了 我 在 科技 领域 的 第 一 次 突破 ， 
并 玛 励 我 与 本 书 。 

还 要 感谢 我 的 伴侣 Malcolm , 她 在 我 写 书 期 间 一 下 给 我 歌 励 。 当 我 因为 写 书 一 下 问 在 家 里 时 ， 
她 很 春心 地 陪伴 我 。 还 要 特别 感谢 我 的 父母 ,培育 了 我 乐于 创造 和 勇于 探索 的 热情 ， 并 和 恳 受 了 我 
那 发 展 不 太 均 衡 的 董 年 时 期 对 8 位 机 的 痴迷 。 还 要 感谢 我 的 祖父 母 ， 送 给 我 一 台 让 我 一 生 热 囊 于 
编程 的 机 带 : Commodore 64。 

在 编写 本 书 的 过 程 中 ，T. .和 Nathan 的 专业 知识 是 无 价 之 宝 ， 他 们 的 幽 和 坎 感 更 是 值得 赞扬 。 
感谢 他 们 如 此 信任 我 们 ， 并 同意 一 起 合作 。Marc Harter 也 提供 了 巨大 的 帮助 ， 他 参与 了 编辑 、 校 
对 和 内 容 的 撰写 这 些 艰 巨 的 任务 ， 这 些 任 务 加 起 来 破 的 很 耗费 精力 。 








MARC HARTER 的 致谢 


感谢 Ryan Dahl, 几乎 在 四 年 前 就 激励 我 认真 对 待 服务 冀 问 JavaScript 编 程 。 感谢 Ben Noordhuis， 
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2 致 谢 








给 了 我 Node 内 部 运作 的 宝贵 资源 。 感 谢 Bert Bates， 信 任 我 、 挑 战 我 ， 写 作 过 程 中 总 是 愿意 施 以 
援手 。 感 谢 Mike 、Nate 和 T. 本 在 关键 时 刻 欢 迎 我 加 入 ， 跟 他 们 合作 是 我 的 汞 季 。 特 别 要 感谢 我 的 
妻子 ， 同 时 也 是 我 的 好 朋友 Hannah， 好 的 荡 励 让 我 得 以 加 入 并 顺利 完成 这 次 新 的 合作 。 











NATHAN RAJLICH 的 致谢 


首先 要 感谢 Guillermo Rauch ， 他 市 我 进入 了 Node.js 社 区 ， 并 大 我 找到 了 目 己 的 位 置 。 还 要 感 
谢 David Blickstein 辟 励 我 如 入 本 书 的 创作 项 目 。 感谢 Ryan Dahl 开 启 了 Node.js 之 门 , 还 要 感谢 最 近 
几 年 一 直 在 出 色 笃 舵 的 Isaac Schlueter。 也 要 感谢 我 的 家 庭 、 我 的 朋友 ， 还 有 我 的 女 有 朋友， 和 仍 受 了 
我 在 这 一 过 程 中 的 不 眠 之 夜 和 各 种 各 样 的 情绪 。 当 然 , 特别 要 感谢 我 的 父母 这 么 多 年 来 对 我 痴迷 
于 计算 机 的 巨大 文 持 。 如 采 不 是 他 们 陪 在 号 边 ， 我 不 会 取得 今天 的 成 绩 。 
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天 于 本 书 











本 书 的 主要 目的 是 教 你 学 会 如 何 创 建 和 部 署 Node 程 序 , 重点 是 Web 程 序 。 本 书 中 有 相当 一 部 
分 内 容 集中 介绍 了 了 Web 程序 框架 Express 和 中 间 件 框架 Connect， 主 要 是 因为 它们 的 用 途 和 社区 的 
文 持 。 你 还 会 学 到 如 何 创建 自动 化 测试 ， 以 及 如 何 部 署 你 的 程序 。 

本 书面 向 希望 用 Node.js 创 建 啊 应 式 、 可 伸缩 程序 的 有 经 验 的 Web 程 序 开发 人 员 。 

为 Node.js 程 序 是 用 JavaScript 写 的 ,所 以 需要 你 和 掌握 这 门 语 言 。 此 外 最 好 还 要 鸣 悉 Windows、 
OS X 或 Linux 命 令 行 。 














路 线 


本 书 被 分 为 三 部 分 。 

第 一 部 分 介绍 了 Node.js， 教 授 了 一 些 用 它 做 开发 所 需要 的 基础 技术 。 第 1 草 曾 述 了 Node 的 特 
征 ， 并 给 出 了 一 些 示 例 代 人 码 。 第 2 童 指导 读者 创建 了 一 个 示例 程序 。 第 3 曹 前 述 了 Node.js 开 发 的 
难 之 处 ， 以 及 可 以 用 来 克服 这 些 困 难 的 技术 ， 并 给 出 了 组 织 程 序 代码 的 办 法 。 

第 二 部 分 在 本 书 中 所 占 比重 最 大 ， 主 要 讨论 Web 程 序 开 发 。 第 4 章 讲 了 基于 Node 创 建 Web 程 
序 的 基础 知识 ， 第 5 草 讨 论 了 如 何 用 Node 存 储 程序 数据 。 

然后 第 二 部 分 继续 深入 Web 相 关 框 染 。 第 6 章 介 绍 了 Connect 框 架 ， 阐述 了 它 的 好 处 和 它 的 工 
作 机 制 。 第 7 章 讲 述 了 Connect 框 架 内 置 的 各 种 组 件 ， 以 及 如 何 用 它们 给 Web 程 序 添 加 功能 。 第 8 
章 介 绍 了 Express 框 架 。 第 9 章 指 导读 者 体验 Express 的 高 级 用 法 。 

涵盖 了 Web 开 发 的 基础 知识 后 ， 第 二 部 分 又 探索 了 两 个 相关 的 主题 。 第 10 章 指导 该 者 使 用 各 
种 Node 测 试 框架 ,第 11 草 讲 了 在 Node Web 程 序 中 如 何 用 模板 将 数据 展示 从 逻辑 中 分 离 出 来 。 

第 三 部 分 转 而 讨论 了 可 以 用 Node 完 成 的 Web 开 发 之 外 的 事情 。 第 12 草 讨论 了 如 何 把 Node 程 序 
部 署 到 生产 服务 硕 上 、 如 何 维护 在 线 时 间 ， 以 及 如 何 将 性 能 提升 到 最 优 。 第 13 草 前 述 了 如 何 创建 
韭 HTTP 程 序 ， 如 何 用 Socket.io 框 染 创 建 实时 程序 ， 以 及 如 何 使 用 一 些 便利 的 Node 内 置 API。 第 14 
章 讨论 了 Node 社 区 的 工作 机 制 ， 以 及 如 何 用 Node 包 管理 带 发 布 Node 作 品 。 


代码 约定 及 下 载 


本 书 代码 齐 循 通用 的 JavaScript 编 码 规范 。 用 空格 ,而 不 是 制 表 符 做 代码 缩 进 。 避 免 一 行 代码 
超过 80 个 字符 。 代 码 清 单 中 ， 很 多 代码 都 加 上 了 注释 ， 指 出 了 其 中 关键 的 概念 。 
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关于 本 书 





每 行 一 条 语句 ， 并 在 简单 语句 末尾 添加 分 号 。 对 于 代码 块 ， 一 条 或 多 条 语句 放 在 大 括号 里 ， 
左边 大 括号 放 在 块 开 头 行 的 末尾 ， 右 边 大 括 扣 缩 进 到 跟 块 开头 行 竖 直 对 齐 的 位 置 。 
你 可 以 从 Manning 出 版 社 的 网 站 上 下 载 书 中 的 示例 代码 , 下 载 地 址 在 www.manning.com/Node 


.]SInAction 。 


作者 在 线 


购买 本 书 英文 版 的 读者 可 以 免费 访问 由 Manning 出 版 社 维 护 的 专用 Web 论 坛 ， 并 在 论坛 中 对 
该 书 发 表 评 论 、 询 问 技术 问题 、 从 作者 和 其 他 用 户 那里 得 到 帮助 。 要 访问 并 订阅 该 论坛 ， 请 访问 
www.manning.com/Node.jsinAction。 这 个 页 面 介绍 了 注册 后 如 何 访 问 论坛 、 可 以 得 到 什么 帮助 以 
及 论坛 上 的 行为 准则 。 

Manning 致 力 于 为 我 们 的 读者 提供 一 个 场所 ， 让 读者 之 间 ， 以 及 读者 和 作者 之 间 进 行 有 意义 
的 对 话 。 但 我 们 并 不 会 强制 作者 参与 ， 他们 在 论坛 上 的 贡献 是 自愿 而 且 不 收费 的 。 我们 建议 你 尽 
量 问 作者 一 些 有 挑战 性 的 问题 ， 以 激发 他 们 的 兴趣 ! 

只 要 本 书 英 文 版 仍然 在 售 , 读者 就 能 从 出 版 社 的 网 站 上 访问 作者 在 线 论 坛 和 之 前 讨论 话题 的 
归档 。” 
































GD 本 书 中 文 版 请 访问 http:/www.ituring.com.cn/book/1061 
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大 于 封面 图 片 


本 书 封面 上 的 画像 标题 为 “城镇 里 的 男人 ”， 摘 目 19 世 纪 法 国 出 版 的 沙 利 文 ， 马 雷 夏 尔 
( Sylvain Maréchal ) 四 卷 本 的 地 域 服饰 风俗 纲要 。 其 中 每 幅 搬 图 都 是 手工 精心 绘制 并 上 和 色 的 。 马 
雷 夏 尔 这 租 书 展示 的 丰富 服饰 ， 令 我 们 强烈 感受 到 200 年 前 乡村 与 城镇 的 巨大 文化 差异 。 不 同 地 
域 的 人 山水 阻隔 ， 言 语 不 通 。 无 论 奔走 于 街 埠 ， 还 是 驻足 于 乡间 ， 通 过 他 们 的 服饰 ， 一 眼 就 能 
出 他 们 的 生活 场所 、 职 业 ， 以 及 生活 境况 。 

时 过 境 迁 ， 书 中 描绘 的 那些 区 域 性 服饰 差异 到 如 今 已 经 不 复 存 在 。 即 使 是 不 同 国家 ， 都 很 难 
再 看 出 人 们 着 猴 的 区 别 ， 再 不 必 说 城镇 和 乡村 了 。 或 许 ,我 们 今天 多 姿 多 彩 的 人 生 , 正 是 从 前 那 
些 文化 差异 的 体现 。 只 不 过 ， 如 今 的 生活 更 加 多 元 ， 而 且 技 术 环境 下 的 生活 节奏 也 更 快 了 。 

今 时 今日 ， 计 算 机 图 书 层出不穷 ，Manning 就 以 马 雷 夏 尔 这 套 书 中 多 样 性 的 图 片 ， 来 表达 对 
IT 行 业 日 新 月 异 的 发 明 与 创造 的 赞美 。 
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| 第 一 部 分 
Node 基础 





学 习 编 程 语 言 或 框架 时 ， 经 党 会 磁 到 新 概念 ， 让 你 以 一 种 新 的 方式 思考 问题 。Node 也 不 例 
外 恒 因 为 尼 对 应 用 牌 厚 弄 妥 的 刚 人 方面 米 取 可 全 种 全 新 的 方 起 

本 书 的 第 一 部 分 会 勾勒 出 Node 与 其 他 平台 的 差异 ， 并 且 讲 解 它 的 基本 用 法 。 你 会 看 到 用 
Node 创 建 的 应 用 程序 长 什么 样子 ， 如 何 组 织 ， 以 及 如 何 处 理 Node 特 有 的 开发 困难 。 你 在 第 一 部 
分 所 学 的 知识 将 成 为 本 书后 续 内 容 的 基础 ， 即 第 二 部 分 详细 介绍 的 如 何 用 Node 创 建 Web 程 序 ， 
以 及 第 三 部 分 讨论 的 如 何 创建 非 Web 程 序 。 
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欢迎 进入 Node.js 世 界 





本 章 内 容 

口 Node.js 是 什么 

口 服务 尊 JavaScript 

口 Node 的 异步 和 事件 触发 本 质 
口 Node 为 谁 而 生 

口 Node 程 序 示例 








Node.js 是 什么 ? 你 很 可 能 已 经 有 所 耳闻 ,其 至 已 经 用 上 了 ,你 也 有 可 能 对 它 很 好 奇 。 现 在 Node 
还 很 年 轻 〈 它 的 首次 亮相 是 在 2009 年 )， 却 非常 流行 。 它 在 Github 受 关注 项 目 排行 榜 上 位 列 第 二 
( https://github.com/joyent/node )， 在 Google 小 组 (http://groups.google.com/group/nodejs ) 和 IRC 频 
道 ( http://webchat.freenode.net/?channels=node.js ) 中 都 有 很 多 追随 者 ， 并 且 社 区 同仁 们 在 NPM 包 
管理 网 站 (http:/npmjs.org ) 上 发 布 的 模块 多 达 15 000 多 个 。 所 有 这 些 都 足以 表明 这 个 平台 的 强 
大 吸引 力 。 

















Node 创 始 人 Ryan Dahl 2009 年 柏林 JSCONF 的 网 站 上 有 Node 创 始 人 Ryan Dahl 第 
一 次 介绍 Node 的 视频 : http://jsconf.eu/2009/video nodejs by ryan dahlhtml” 。 


官网 上 (http:/www.nodejs.org ) 给 Node 下 的 定义 是 :“ 一 个 搭建 在 Chrome JavaScript 运 行 时 
上 的 平台 ， 用 于 构建 高 速 、 可 伸缩 的 网 络 程序 。Node.js 采 用 的 事件 驱动 、 非 阻 寨 1/O 模 型 ， 使 它 
既 轻 量 又 高 效 ， 并 成 为 构建 运行 在 分 布 式 设备 上 的 数据 密集 型 实时 程序 的 完美 选择 。” 

我 们 在 本 草 中 会 看 到 下 面 这 些 概念 : 

口 为 什么 JavaScript 对 服务 端 开 发 很 重要 ; 

口 浏览 厚 如 何 用 JavaScript 处 理 IO ; 

D Node 在 服务 端 如 何人 处理 1/O; 

口 DIRT 程 序 是 什么 意思 ， 为 什么 适 于 用 Node 开 发 ; 

口 几 个 基础 的 Node 程 序 示例 。 




















中 已 经 看 不 到 了 ， 被 拿 掉 了 。 一 一 译 者 注 
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我 们 先 把 视线 转 到 JavaScript 上 ……… 


1.1 构建 于 JavaScript 之 上 


无 论 好 坏 ，JavaScript 都 是 世界 上 最 流行 的 编程 语言 "。 只 要 你 做 过 Web 程 序 ， 就 肯定 过 到 过 
JavaScript。JavaScript 儿 乎 裔 布 于 Web 上 的 每 个 角 沙 ， 所 以 它 已 经 实现 了 Java 在 20 世 纪 90 年 代 “ 一 
次 编写 ， 处 处 运行 ”的 梦想 。 

在 2005 年 Ajax 时 命 前 后 ，JavaScript 从 一 门 “ 写 看 玩 儿 ”的 语言 变 成 了 一 种 被 人 们 用 来 编写 真 
正 的 、 重 要 的 程序 的 声言。 这些 程序 中 比较 引 人 注 目的 先行 者 是 Google 地 图 和 Gmail， 但 现在 类 
似 的 Web 应 用 有 一 大 堆 ， 从 Twitter 到 Facebook， 再 到 GitHub。 

目 从 2008 年 年 末 Google Chrome 发 布 以 来 ,得 益 于 浏览 妖 厂 向 (Mozilla、 微 软 、 侠 果 、Opera 
和 谷歌 ) 的 白热化 苑 争 ，JavaScript 的 性 能 以 不 可 思议 的 速度 得 到 了 大 幅 提 升 。 现 代 化 JavaScript 
虚拟 机 的 性 能 正 改 变 着 可 以 构建 在 Web 上 的 应 用 类 型 。” 一 个 很 有 说 服 力 的 、 坦 率 地 说 是 令 人 震 
惊 的 例子 是 jslinux，” 一 个 运行 在 JavaScript 中 的 PC 模拟 器 ， 它 能 加 载 Linux 内 核 ， 可 以 利用 终端 
会 话 与 其 交互 ， 还 能 编译 C 程 序 ， 而 这 一 切 都 是 在 浏览 希 中 完成 的 。 

在 服务 需 闪 编程 ，Node 使 用 的 是 为 Google_ Chrome 提供 动力 的 V8 虚 拟 机 。V8 让 Node 在 性 能 
上 得 到 了 巨大 的 提升 ， 因 为 它 去 择 了 中 间 环 节 ， 执 行 的 不 是 字 世 人 码 ,， 用 的 也 不 是 解释 硕 ， 而 是 直 
接 编 详 成 了 本 地 机 带 码 。Node 在 服务 带 端 使 用 JavaScript 还 有 其 他 好 处 。 

口 开发 人 员 用 一 种 语言 就 能 编写 整个 web 应 用 , 这 可 以 减少 开发 客户 端 和 服务 端 时 所 需 的 语 
言 切 换 。 这 样 代码 可 以 在 客户 问 和 服务 端 中 共享 ， 比 如 在 表单 校 验 或 游戏 逻辑 中 使 用 同 
样 一 段 代码。 

D JSON 是 目前 非常 流行 的 数据 交换 格式 ， 并 且 还 是 JavaScript 原 生 的 。 

口 有 些 NoSQL 数 据 库 中 用 的 就 是 JavaScript 语 言 〈 比 如 CouchDB 和 MongoDB )， 所 以 跟 它 们 
简直 是 天 作 之 合 ( 比如 MongoDB 的 管理 和 查询 语言 都 是 JavaScript; CouchDB 的 map/reduce 
也 是 JavaScript )。 

口 JavaScript 是 一 门 编译 目标 语言 ， 现 在 有 很 多 可 以 编译 成 JavaScript 的 语言 "。 

口 Node 用 的 虚拟 机 ( V8 ) 会 紧 跟 ECMAScript 标 准 。” 换 句 话 说， 在 Node 中 如 果 想 用 新 的 
JavaScript 语 言 特 性 ， 不 用 等 到 所 有 浏览 需 都 文 持 。 

JavaScript 竞 然 成 了 一 种 引 人 瞩 目的 编写 服务 端 应 用 的 语言 ， 之 前 谁 能 料 到 呢 ? 基于 前 面 提 

到 的 缆 盖 范围 、 性 能 和 其 他 特性 ，Node 已 经 赚 足 了 眼球 。 但 JavaScript 只 是 整 幅 拼 图 中 的 一 块 ; 
Node 使 用 JavaScript 的 方式 则 更 为 有 趣 。 为 了 理解 Node 环 境 ， 我 们 先 看 看 你 最 熟悉 的 JavaScript 
























































中 参见 YouTube 上 的 “JavaScript: 你 的 新 霸主 ”: www.youtube.com/watch?v=Trurfqh_6fQ 

@) 参见 “Chrome 实 验 ” 页 面 上 的 一 些 例子 : www.chromeexperiments.com/ 

(3) jslinux ，JavaScript 的 一 球 PC 模 拟 器 : http://bellard.org/jslinux/ 

由 参见 “编译 成 JS 的 语言 清单 ”: https://github.com/jashkenas/coffee-script/wiki/List-of-languages-that-compile-to-JS 
(9) 要 了 解 ECMAScript 标 准 的 详细 信息 ， 请 参见 维基 百科 : http:/en.wikipedia.org/wiki/ECMAScript 
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环境 : 浏览 厚 。 


1.2 异步 和 事件 触发 :浏览 器 


Node 为 服务 端 JavaScript 提 供 了 一 个 事件 驱动 的 、 异 步 的 平台 。 它 把 JavaScript 末 到 服务 端 中 
的 方式 跟 浏览 硕 把 JavaScript 计 到 客户 冰 的 方式 几乎 一 模 一 样 。 了 解 浏 览 顶 的 工作 原理 对 我 们 了 解 
Node 的 工作 原理 会 有 很 大 帮助 。 它 们 都 是 事件 驱动 (用 事件 轮 询 ) 和 非 阻塞 的 TO 处 理 〈 用 异步 
IO )。 下 面 举 个 例子 说 明 这 是 什么 意思 。 
事件 轮 询 和 异步 |/O 〇 ”要 了 解 更 多 有 关 事 件 轮 询 和 蜡 步 1O 的 知识 ,请 参见 相关 的 维基 
百科 文章 : http://en.wikipedia.org/wiki/Event loop 和 http://en.wikipedia.org/wiki/Asynchronous IO。 


我 们 来 看 一 小 段 ]Query 用 XMLHttpRequest( XHR ) 做 Ajax 请 求 的 代码 : 


S$.post('/resource.jJjson', function (data) { 


console.log(data).; | I/O 不 会 阻塞 执行 





/ /有 本 纺 续 技 行 
这 个 程序 会 发 送 一 个 到 resource.json 的 HITP 请 求 。 当 啊 应 返回 时 会 调用 市 着 参数 aata 的 匿名 
限 数 (在 这 个 上 下 文中 的 “回调 函数 ”)，data 就 是 从 那个 请 求 中 得 到 的 数据 。 
注意 ， 代 码 没 有 写成 下 面 这 样 : 
var data = $.post('/resource.json'); < 一 在 I/O 完 成 之 前 程序 会 被 阻塞 
console.1Lodc(dqata) ; 


在 这 个 例子 中 ， 假 定 对 resource.json 的 啊 应 在 准备 好 后 会 存储 在 变量 aata 中 ， 并 且 在 此 之 前 
国 数 console .1og 不 会 执行 。LO 操 作 (Ajax 请 求 ) 会 “阻塞 ”脚本 继续 执行 ， 直 到 数据 准备 好 。 
因为 浏览 器 是 单线 程 的 ， 如 果 这 个 请 求 用 了 400ms 才 返回 ， 那 么 页 面 上 的 其 他 任何 事件 都 要 等 到 
那 之 后 才能 执行 。 可 以 想象 一 下 ， 如 果 一 幅 动 画 被 停 住 了 ,或 者 用 户 试 着 跟 页 面 交 互 时 动 不 了 ， 
那 种 用 户 体验 有 多 糟糕 。 

谢 天 谢 地 ， 实 际 情况 不 是 这 样 的 。 当 浏览 硕 中 有 LO 操作 时 ， 该 操作 会 在 事件 轮 询 的 外 面 执 
行 (脚本 执行 的 主 顺序 之 外 )， 然 后 当 这 个 IO 操作 完成 时 ， 它 会 发 出 一 个 “事件 ”, “会 有 一 个 也 
数 ( 通 当 称 作 “ 回 调 ”) 处 理 它 ， 如 图 1-1 所 示 。 

这 个 VO 是 异步 的 ， 并 且 不 会 “ 阻 窒 ”脚本 执行 ， 事件 轮 询 仍 然 可 以 啊 应 页 面 上 执行 的 其 他 
交互 或 请 求 。 这 样 ， 浏览 妖 可 以 对 客户 做 出 啊 应 ， 并 且 可 以 处 理 页 面 上 的 很 多 交互 动作 。 

请 牢记 上 面 这 些 内 容 ， 现 在 我 们 切换 到 服务 端 。 






































dg 注意, 在 浏览 器 中 有 几 种 特殊 情况 会 “阻塞 ”程序 执行 ,并 且 通 常 我 们 会 建议 你 不 要 使 用 它们 : alert、 prompt、 confirm 
和 同步 XHR 。 
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一 一 一 


事件 轮 询 
Pad = 
a 1. 对 resources.json 
2 发 起 Ajax 请 求 
‘/ TEeSOUTCC.JSON 
/ 
/ 
/ 
/ 
/ / 
/ / 
, ,等 待 …… 
/ 

/ / 

/ Se 

1 人 

pd 
$s.post('/resource.json', function (data) { pad 
console.log(data); pa 
和 x 4. 最 后 ， 对 resources.json 的 Ajax 响应 
和 回来 了 ， 并 在 回调 中 做 了 处 理 


3. 另 一 个 Ajax 啊 应 回来 了 


2. 用 户 点 击 ; onclick 事 件 处 理 


图 1-1 浏览 硕 中 非 阻塞 IO 的 例子 


1.3 ”异步 和 事件 触发 服务 器 


可 能 大 多 数 人 都 了 解 传 统 的 服务 病 编 程 的 VO 模型 ， 就 像 1.2 市 那个 “阻塞” 的 jQuery 例子 一 
样 。 下 面 是 一 个 PHP 的 例子 : 

sresult = mysql query('SELECT * FROM myTable'); 在 数据 库 查 询 完成 之 前 程序 

print_r(S$Sresult); 不 会 继续 执行 

这 上段 代码 做 了 些 VO 操 作 ， 并 且 在 所 有 数据 回来 之 前 ， 这 个 进程 会 被 阻 罕 。 对 于 很 多 程序 而 
言 ， 这 个 模型 没什么 问题 ， 并 且 很 容易 理解 。 但 有 一 点 可 能 会 被 忽略 : 这 个 进程 也 有 状态 ,或 者 
说 内 存 空 间 , 并 且 在 LO 完成 之 前 基本 上 什么 也 不 会 做 ,根据 WO 操作 的 延迟 情 况 , 那 可 能 会 有 10ms 
到 几 分钟 的 时 间 。 延 返 也 可 能 是 由 下 列 意外 情况 引发 的 : 

口 便 盘 正在 执行 维护 操作 ， 谈 / 写 都 暂 俘 了 ; 

口 因为 负载 增加 ， 数 据 库 查 询 变 得 更 慢 了 ; 

口 由 于 某 种 原因 ， 今 天 从 sitexyz.com 拉 取 资 源 非 常 迟 绥 。 

如 有 果 程 序 在 IO 上 阻塞 上， 当 有 更 多 请 求 过 来 时 ， 服 务 融会 怎么 处 理 呢 ? 在 这 种 情景 中 通 稍 
会 用 多 线程 的 方式 。 一 种 第 见 的 实现 是 给 每 个 连接 分 配 一 个 线程 ,并 为 那些 连接 设置 一 个 线程 池 。 
你 可 以 把 线程 想象 成 一 个 计算 工作 区 , 处理 右 在 这 个 工作 区 中 完成 指定 的 任务 。 线程 通常 都 是 处 
于 进程 之 内 的 ,并 且 会 维护 它 目 己 的 工作 内 存 。 每 个 线程 会 处 理 一 到 多 个 服务 需 连 接 。 尽 管 这 上 听 
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起 来 是 个 很 目 然 的 委派 服务 右 劳 动力 的 方式 ( 最 起 码 对 那些 曾经 长 期 采用 这 种 方式 的 开发 人 员 来 
说 是 这 样 的 )， 但 程序 内 的 线程 管理 会 非常 复杂 。 此 外 ， 当 需要 大 量 的 线程 处 理 很 多 并 发 的 服务 
器 连接 时 ， 线 程 会 消耗 额外 的 操作 系统 资源 。 线 程 需要 CPU 和 额外 的 RAM 来 做 上 下 文 切 换 。 

为 了 说 明 这 一 点 ， 我 们 来 看 NGINX 和 Apache 的 一 个 基准 比较 ( 见 图 1-2， 源 目 http:/mng.bz 
/eaZT )。 或 许 你 还 不 了 解 NGINX ( http://nginx.com/ )， 它 跟 Apache 一 样 ， 是 个 HTTP 服务 硕 ,， 但 它 
用 的 不 是 市 有 阻塞 IO 的 多 线程 方式 ， 而 是 市 有 异步 IO 的 事件 轮 询 〈 就 像 浏 览 硕 和 Node 一 样 )。 
为 这 些 设计 上 的 选择 ，NGINX 通 党 能 处 理 更 多 的 请 求 和 客户 问 连 接 ， 它 因此 变 成 了 啊 应 能 
更 强 的 解决 方案 *。 











NGINX | 
10000 | Apache 
| 

















500 1000 1500 2000 2500 3000 3500 Concurren t 


人 每 秒 处 理 的 请 求 数 
@ 打开 的 客户 端 /服务 器 连接 数 


@@ 像 NGINX 这 样 采用 异步 和 事件 触发 方式 的 程序 ， 可 以 
处 理 更 多 的 客户 端 及 服务 绒 端 通信 


人 @O 这 样 的 程序 响应 能 力也 更 强 ， 在 这 个 例子 中 ， 连 接 数 
为 3500 时 ，NGINX 的 请 求 处 理 速度 几乎 要 快 三 入 


图 1-2 WebFaction Apache/NGINX 基 准 比较 


在 Node 中 ，IO 几 乎 总 是 在 主事 件 轮 询 之 外 进行 ， 使 得 服务 器 可 以 一 直 处 于 高 效 并 且 随 时 能 
够 做 出 响应 的 状态 ， 就 像 NGINX-- 样 。 这 样 进程 就 更 加 不 会 受 VO 限 制 ， 因 为 IO 延 迟 不 会 拖 垮 服 
务 器 ， 或 者 像 在 阻塞 方式 下 那样 占用 很 多 资源 。 因 此 一 些 在 服务 器 上 曾经 是 重量 级 的 操作 ， 在 
Node 服 务 器 上 仍然 可 以 是 轻 量 级 的 。? 

这 个 混杂 了 事件 驱动 和 异步 的 模型 , 加 上 几乎 随处 可 用 的 JavaScript 语 言 , 帮 我 们 打开 了 一 个 
精彩 纷呈 的 数据 密集 型 实时 程序 的 世界 。 























1.4 ” DIRT 程序 
实际 上 ，Node 所 针对 的 应 用 程序 有 一 个 专门 的 简称 : DIRT。 它 表示 数据 密集 型 实时 








中 如 果 你 对 这 个 问题 感 兴 趣 ， 想 了 解 更 多 内 容 ， 请 参见 “C10K 问 题 *: http:/www.kegel.conmy/c10k.html 
@) Node 的 “关于 ”页 面 中 有 更 详细 的 讲解 : http://nodejs.org/about/ 
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( data-intensive real-time ) 程序 。 因 为 Node 自 身 在 VO 上 非常 轻 量 ， 它 善于 将 数据 从 一 个 管道 混 排 
或 代理 到 另 一 个 管道 上 , 这 能 在 处 理 大 量 请 求 时 持 有 很 多 开放 的 连接 , 并 且 只 占用 一 小 部 分 内 存 。 
它 的 设计 目标 是 保证 啊 应 能 力 ， 跟 浏览 硕 一 样 。 

对 Web 来 说 ， 实 时 程序 是 个 新 生 事物 。 现 在 有 很 多 Web 程 序 提供 的 信息 几乎 都 是 即时 的 ， 比 
如 通过 白板 在 线 协作 、 对 临近 公交 车 的 实时 精确 定位 ， 以 及 多 人 人 在线 游戏 。 不管 是 用 实时 组 件 增 
强 已 有 程序 ， 还 是 打造 全 新 的 程序 ，Web 都 在 绷 着 啊 应 性 和 协作 型 环境 逐渐 进发 。 而 这 种 新 型 的 
Web 应 用 程序 需要 一 个 能 够 实时 啊 应 大 量 并 发 用 户 请 求 的 平台 来 文 撑 它 们 。 这 正 是 Node 所 擅长 的 
领域 ， 并 且 不 仅 限 于 Web 程 序 ， 其 他 IO 负载 比较 重 的 程序 也 可 以 用 到 它 。 

Browserling (browserling.com， 见 图 1-3 ) 就 是 一 个 用 Node 开 发 的 DIRT 程 序 ， 它 是 一 个 很 好 
的 范例 。 在 这 个 网 站 上 ,我 们 可 以 在 浏览 硕 中 使 用 各 种 浏览 锅 。 这 对 Web 前 端 开 发 工程 师 来 说 特 
别 有 用 , 因为 他 们 再 也 不 用 仅仅 为 了 测试 就 去 装 一 堆 的 浏览 硕 和 操作 系统 了 。Browserling 用 了 一 
个 叫做 StackVM 的 由 Node 驱 动 的 项 日， 而 StackVM 管 理 了 用 QEMU ( 快速 模拟 器 ) 模拟 器 创建 的 
虚拟 机 ，QEMU 会 模拟 运行 浏览 器 所 需 的 CPU 和 外 设 。 
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图 1-3 ”Browserling: 用 Node.js 做 路 浏览 器 的 交互 测试 


Browserling 在 VM 中 运行 测试 浏览 硕 ， 将 键盘 和 鼠标 的 输入 数据 从 用 户 的 浏览 硕 中 转 到 模拟 
出 来 的 浏 览 需 中 , 然后 将 模拟 浏览 锅 中 要 重新 泻 染 的 区 域 转 出 来 , 在 用 户 浏览 套 的 画布 上 重新 画 
出 来 。 图 1-4 辐 我 们 呈现 了 这 一 过 程 。 

Browserling 还 有 一 个 使 用 Node 的 互补 项 目 Testling ( testling.com )， 它 可 以 通过 命令 行 在 多 个 
浏览 硕 上 并 行 运行 测试 包 。 

Browserling 和 Testling 都 是 很 好 的 DIRT 程 序 范例 ， 并 且 构 建 像 它们 这 样 可 伸缩 的 网 络 程序 所 
用 的 基础 设施 在 你 坐 下 来 写 第 一 个 Node 程 序 时 就 在 发 挥 作用 了 。 我 们 来 看 看 Node 的 API 是 如 何 提 
供 这 些 开 箱 即 用 的 工具 的 。 
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用 户 的 鼠标 和 键盘 事件 
Browserling.com WebSocket , 模拟 浏览 絮 
HTML5 画 布 ws (QEMU) 
以 数据 URI 形 式 更 新 的 图 片 


(人 用 户 在 浏览 器 中 的 鼠标 和 键盘 事件 通过 WebSocket 实 时 传 给 Node.js， 
然后 它 又 将 它们 传 给 模拟 器 ， 


2 受用 户 的 交互 影响 要 在 模拟 浏览 器 中 重新 演 染 的 区 域 通 过 Node 和 
WebSocket 以 数据 流 的 形式 传 回 来 ， 画 在 浏览 器 的 画布 上 。 


图 1-4 Browserling 的 工作 流 


1.5 默认 DIRT 


Node 从 构建 开始 就 有 一 个 事件 驱动 和 异步 的 模型 。JavaScript 从 来 没有 过 标准 的 VO 库 ， 那 是 
服务 疹 语 言 的 稼 见 配 置 。 对 于 JavaScript 而 言 ， 这 总 是 由 “ 衙 主 ”环境 决定 的 。JavaScript 最 稼 见 
的 宿主 环境 ， 也 是 大 多 数 开发 人 员 所 用 的 ， 就 是 浏览 顶 ， 它 是 事件 驱动 和 异步 的 。 

Node 重 新 实现 了 特 主 中 那些 常用 的 对 象 ， 尽 量 让 浏览 硕 和 服务 大 保持 一 致 ， 比 如 : 

口 计时 豆 API ( 比如 setTimeout ); 

口 控制 台 API ( 比如 console.1log )。 

Node 还 有 一 组 用 来 处 理 多 种 网 络 和 文件 VO 的 核心 模块 。 其 中 包括 用 于 HTTP、TLS、HTTPS、 
文件 系统 ( POSIX )、 数 据 报 (UDP ) 和 NET (TCP ) 的 模块 。 这 些 核心 模块 刻意 做 得 很 小 、 底 层 
并 且 和 俐 单 ， 只 包含 要 给 基于 LO 的 程序 用 的 组 成 部 分 。 第 三 方 模块 基于 这 些 核心 模块 ， 针 对 常见 
的 问题 进行 了 更 高 层 的 抽象 。 




















平台 与 框 染 
Node 是 JavaScript 程 序 的 平台 ， 不 要 把 它 跟 框架 相 混 消 。 很 多 人 都 误 把 Node 当 做 JavaScript 


上 的 Rails 或 Django， 实 际 上 它 更 底层 。 
但 如 果 你 对 Web 程 序 的 框架 感 兴趣 ， 本 书后 面 会 介绍 在 Node 中 非常 流行 的 Express 框 架 。 


聊 了 这 么 多 了 ， 你 可 能 很 想 知道 Node 程 序 的 代 公 长 什么 样子 。 我 们 来 看 几 个 人 简单 的 例子 : 
口 一 个 简单 的 异步 程序 ; 

口 一 个 Hello World Web 服 务 人 此; 

口 一 个 数据 流 的 例子 。 
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我 们 先 来 看 一 个 人 简单 的 异步 程序 。 
1.5.1 简单 的 异步 程序 
你 应 该 在 1.2 节 见 过 下 面 这 个 使 用 jQuery 的 Ajax 例子 : 
Ss.post{('/resource.Json', function (data) { 


console.1og{data),; 


J 




















我 们 要 在 Node 里 做 一 个 跟 这 个 差不多 的 例子 ， 不 过 这 次 是 用 文件 系统 ( fs ) 模块 从 便 盘 中 
加 载 resource.json。 注 意 看 下 面 这 个 程序 跟前 面 那个 jQuery 的 例子 有 多 像 : 

Var fs = regquire('fs'); 

fs.readFilje(',/resource.json', function (er, data) 1 


console.log(data); 


}) 

这 上 段 程序 要 从 便 盘 里 读 取 resource.json 文 件 。 当 所 有 数据 都 读 出 来 后 ， 会 调用 那个 匿名 吗 数 
( 即 “ 回 调 函 数 ”)， 传 给 它 的 参数 是 er ( 如 果 出 现 错误 ) 和 data (文件 中 的 数据 )。 

这 个 过 程 是 在 后 人 台 完 成 的 , 这 样 在 该 过 程 中 ,我们 可 以 继续 处 理 其 他 任何 操作 ， 下 到 数据 准 
备 好 。 我 们 之 前 说 过 的 那些 事件 触发 和 异步 的 好 处 都 是 目 动 实现 的 。 差别 在 于 ,这 个 不 是 在 浏览 
器 中 用 jQuery 发 起 一 个 Ajax 请 求 ， 而 是 在 Node 中 访问 文件 系统 抓 取 resourcejson。 后 面 这 个 过 程 
如 图 1-5 所 示 。 


事件 轮 询 ， 
1. 请 求 resource.json 文 件 
区 
7 
resource.json 
J 
/ 
/ 
/ 
/ / 
/ / 
/ 
/ 等 待 和 
j a 
1 
Var fs = require('fs');: 区 
fts.readFilet'./resource.json', tunction {err, data} A 4. 最 终 resource.json 文 件 中 的 数据 回来 了 
console.logldata)}),; x Ee 并 在 回调 函数 中 做 了 处 理 


于 es Ser 人 


3 另外 一 个 IO 操作 完成 了 


2. 触发 了 一 个 事件 


图 1-$_ Node 中 的 非 阻塞 IO 示例 
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1.5.2 ”Hello World HTTP 服 务 器 








Node 铝 被 用 来 构建 服务 磊 。 有 了 Node， 创 建 各 种 服务 咒 变 得 非常 简单 。 如 果 你 过 去 习惯 于 
把 程序 部 署 到 服务 需 中 运行 (比如 把 PHP 程 序 放 到 Apache HTTP 服 务 右 上 ), 可 能 会 党 得 这 种 方式 
很 怪异 。 在 Node 中 ， 服 务 右 和 程序 是 一 样 的 。 
下 面 是 个 徐 单 的 HTTP 服 务 硕 实现 ， 它 会 用 “Hello World” 啊 应 所 有 请 求 : 
var http = require('http'); 
http.createServer{function (req, res) 1 
res.writeHead{200, {'Content-Type': 'text/plain'});} 
res.end{'Hello World\n').: 
}}.listen(3000).; 
console.log(t'Server running at http://localhost:3000/').; 


只 要 有 请 求 过 来 ， 它 就 会 激发 回调 也 数 function (req，res), 把 “Hello World” 写 人 到 
响应 中 返回 去 。 这 个 事件 模型 跟 浏览 器 中 对 onclick 事 件 的 监听 类 似 。 在 浏览 器 中 ， 点击 事 件 随 
时 都 可 能 发 生 , 所 以 要 设置 一 个 函数 来 执行 对 事件 的 处 理 逻 辑 , 而 Node 在 这 里 提供 了 一 个 可 以 随 
时 响应 请 求 的 函数 。 

下 面 是 同一 服务 大 的 另 一 种 写法 ， 这 样 看 起 来 request 事 件 更 明显 : 
































var http = require('http'); 为 request 设 置 一 个 

Var server = http.createServer(); 事件 监听 器 

SErver. On (reusest', functLon (Ted, FeS) -1 ee 
res.writeHead(200, {'Content-Type': 'text/plain'}); 


res.end{'Hello World\n').;: 
}) 
Server.listen{3000); 
console.1log{('Server running at http://localhost:3000/').; 


1.5.3” 流 数据 
Node 在 数据 流 和 数据 流动 上 也 很 强大 。 你 可 以 把 数据 流 看 成 特殊 的 数组 , 只 不 过 数组 中 的 数 
据 分 散在 空间 上 ， 而 数据 流 中 的 数据 是 分 散在 时 间 上 的 。 通 过 将 数据 一 块 一 块 地 传送 ,开发 人 员 


可 以 每 收 到 一 块 数 据 就 开始 处 理 ， 而 不 用 等 所 有 数据 都 到 全 了 再 做 处 理 。 下 面 我 们 用 数据 流 的 方 
式 来 处 理 resource.json: 





Var stream = fs.createReadStream('./resource.json') 
stream.on('data', function (chunk) { 

console.1log (chunk) 当 有 新 的 数据 块 准备 好 
} ed 


stream.on('end', function () { 
console.log('finished') 


}) 

只 要 有 新 的 数据 块 准备 好 ， 就 会 激发 aata 事 件 ， 当 所 有 数据 块 部 加 载 完 之 后 ， 会 激发 一 个 
end 事 件 。 由 于 数据 类 型 不 同 ， 数 据 块 的 大 小 可 能 会 发 生变 化 。 有 了 对 读 取 流 的 奔 层 访问 ， 程 序 
就 可 以 边 读 取 边 处 理 ， 这 要 比 等 看 所 有 数据 都 绥 存 到 内 存 中 再 处 理 效率 局 得 多 。 

Node 中 也 有 可 写 数据 流 ， 可 以 往 里 写 数 据 块 。 当 HTTP 服 务 太 上 有 请 求 过 来 时 ， 对 其 进行 啊 
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应 的 res 对 象 束 是 可 写 数 据 流 的 一 种 。 

可 读 和 可 写 数据 流 可 以 连接 起 来 形成 管道 ， 就 像 shell 脚 本 中 用 的 | (管道 ) 操作 符 一 样 。 这 
是 一 种 高 效 的 数据 处 理 方 式 ， 只 要 有 数据 准备 好 就 可 以 处 理 , 不 用 等 着 读 取 完整 个 资源 再 把 它 写 
出 去 。 

我 们 借用 一 下 前 面 那 个 HTTP 服 务 厦 ， 看 看 如 何 把 一 张 图 片 流 到 客户 端 : 


var http = require('http').; 

















var fs = regquire('fs'); 

http.createServer(function (req, res) { 设置 一 个 从 读 取 流 到 
res.writeHead(200, {'Content-Type': 'image/png'}); | 写 出 流 的 管道 
fs.createReadStream('./image.png') .pipe (res); 


}) .listen(3000); 
console.log('Server running at http://localhost:3000/'); 


在 这 行 代码 中 ， 数 据 从 文件 中 读 进 来 ( fs .createReadStream )， 然 后 数据 随 着 进来 就 被 
送 到 ( .pipe ) 客户 并 ( res )。 在 数据 流动 时 ， 事 件 轮 询 还 能 处 理 其 他 事件 。 

Node 在 多 个 平台 上 均 上 默认 提供 了 DIRT 方 式 ， 包 括 各 种 Windows 和 类 UNIX 系 统 。 底 层 的 1/O 
库 (libuv ) 特意 屏蔽 了 宿主 操作 系统 的 差异 性 ， 提供 了 统一 的 使 用 方式 ， 如 果 需 要 的 话 ， 程序 可 
以 在 多 个 设备 上 轻松 移植 和 运行 。 


1.6 小结 


Node 跟 所 有 技术 一 样 , 并 不 是 万 能 灵 药 。 它 只 能 解决 特定 的 问题 , 并 为 我 们 开创 新 的 可 能 性 。 
Node 比 较 有 意思 的 一 点 是 ， 它 让 从 事 系统 各 方面 工作 的 人 走 到 了 一 起 。 很 多 进入 Node 世 界 的 是 
客户 闪 JavaScript 程 序 员 ,此 外 还 有 服务 端 程序 员 以 及 系统 层面 的 程序 员 。 不 管 你 是 做 什么 的 , 我 
们 都 希望 你 能 了 解 Node 到 底 适 合 帮 你 完成 什么 样 的 任务 。 

回顾 一 下 ， Node 是 : 

口 构建 在 JavaScript 之 上 的 ; 

口 事件 触发 和 异步 的 ; 

口 专 为 数据 密集 型 实时 程序 设计 的 。 

我 们 在 第 2 章 会 构建 一 个 简单 的 DIRT Web 程 序 ， 好 让 你 了 解 Node 程 序 是 如 何 工作 的 。 
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构建 有 多 个 房间 的 
聊天 宇 程 友 





本 章 内 容 

口 认识 各 种 Node 组 件 

口 一 个 用 Node 做 的 实时 程序 
口 服务 需 跟 客户 端 交 互 





第 1 草 介 绍 了 用 Node 做 异步 开发 跟 传统 的 同步 开发 有 什么 不 同 。 本 曹 会 创建 一 个 事件 驱动 的 
聊天 小 程序 , 让 你 通过 实战 了 解 Node。 如 采 这 一 章 里 的 某 些 细节 让 你 党 得 很 尝 ,， 爷 不 要 担心 。 我 
们 只 是 想 的 开 Node 开 发 的 神秘 面纱 ， 让 你 提前 看 看 读 完 这 本 书后 你 能 做 些 什么 样 的 程序 。 

本 章 内 容 假定 你 有 Web 程 序 开发 的 经 验 , 对 HTTP 有 基本 的 认识 , 并 且 熟 悉 jQuery。 随 着 本 章 
内 容 逐 步 展开 ， 你 将 : 

口 游览 这 个 程序 ， 了 解 它 是 如 何 工作 的 ; 

口 审查 技术 需求 ， 并 完成 程序 的 初始 设置 ; 

D 提供 程序 所 需 的 HTML、CSS 和 客户 病 JavaScript; 

口 用 Socket.IO 处 理 跟 聊天 相关 的 消息 ; 

口 用 客户 端 JavaScript 做 程序 的 UI。 

我 们 先 从 程序 的 概览 开始 ， 看 看 这 个 程序 长 什么 样 ， 以 及 等 完成 后 它 的 表现 如 何 。 


2.1 程序 概览 


本 章 会 构建 一 个 在 线 聊 天 程序 , 用 户 可 以 在 一 个 简单 的 表单 中 输入 消息 , 相互 聊天 , 如 图 2-1 
所 示 。 消 息 输 入 后 会 发 送 给 同一 个 聊天 室内 的 其 他 所 有 用 户 。 
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You are ac YY as Guest?, 


You are now known as Guest3. 





Room changed. Room chang 
Users currently in Lobby: Mary Anne MacLean, Bobcat. pe Comerty in Lobby; Mary Anne MacLean, Bobcat, 
ello chat! 
消息 出 现 
在 这 里 





在 这 里 
输入 消息 





图 2-1 在 聊天 程序 中 输入 一 条 消息 
进入 聊天 室 后 ， 程 序 会 自动 给 用 户 分 配 一 个 昵称 ， 但 他 们 可 以 用 聊天 命令 修改 自己 的 昵称， 
如 图 2-2 所 示 。 聊 天 命令 以 斜 杜 ( / ) 开头 。 


通知 用 户 
昵称 变 了 me 


| Chat 


一 
( 避 ) 到 127.0.0.1:30 




















Lobby 


You are now known as Guest3. 
Room changed. 
Users currently in Lobby: Mary Anne MacLean, Bobcat., 
~ Hello chat! 
会 Youare now known as Mel Lyman. 


You are now known as Guest3. 

Room changed. 

Users currently in Lobby; Mary Anne MacLean, Bobcat. 
Hello chat! 








jnick Mel Lyman 





2 Chat commands vat Commands 
a Change nickname: /ricx [userrane] s Change nickname: /naicx [usernane] 
/ e Join/create roomr /on 1rocm nan0) es Joinfcreate room /join 【zccm ssne) 
/ 
/ 
/ 


一 修改 昵称 的 聊天 命令 
图 2-2 ”修改 聊天 中 的 昵称 


同样 ， 用 户 也 可 以 输入 命令 创建 新 的 聊天 室 (或 加 入 已 有 的 聊天 室 )， 如 图 2-3 所 示 。 在 加 入 
或 创建 聊天 室 时 , 新 聊天 室 的 名 称 会 出 现在 聊天 程序 顶端 的 水 平 条 上 , 也 会 出 现在 聊天 消息 区 域 
右 侧 的 可 用 房间 列表 中 。 
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一 一 当前 房间 


ANN 





Chat I -~ | 一 


\ (4) 127.0.0.1:30 c 区 多 





他 


Lobby 


You are now known as Guest3. 

Room changed. 

Users currently in Lobby: Mary Anne MacLean, Bobcat. 
Hello chat! 

You are now known as Mel Lyman. 


由 所 有 用 户 
一 创建 的 房间 
列表 








| Lounge 
了 
Chat comman ds 
Change my [user: 
Joimicrea m room nare 


加 入 /创建 房间 的 命令 
图 2-3 ”修改 房间 
在 用 户 换 到 新 房间 后 ， 系 统 会 确认 这 一 变化 ， 如 图 2-4 所 示 。 
-房间 的 加 入 /创建 得 到 了 确认 








a0n 9 Chat 
Chat | 二 | 一 
(@) ® 127.00.13000 > C 区 全 - coooke SCICB 
Lounge 


Ye re now known as CUest?. 

Room changed. 

Users currently in Lobby: Mary Anne MacLean, Bobcat. 
Hello chat! 


You are now known as Mel Lyman. 
Room changed. 


4 


图 2-4 ” 换 到 新 房间 的 结 








虽然 从 功能 上 看 这 个 程序 充其量 只 能 算 一 个 准 系 统 ， 但 它 已 经 可 以 展示 构建 实时 Web 程 序 
所 需 的 重要 组 件 和 基本 技术 了 。 这 个 程序 表明 了 Node 如 何 同时 处 理 传统 的 HTTP 数 据 ( 比如 葛 态 


文件 ) 和 实时 数据 (聊天 消息 ) 通过 它 还 能 看 出 Node 程 序 是 如 何 组 织 的 ， 以 及 依赖 项 是 如 何 管 
理 的 。 
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现在 我 们 来 看 看 实现 这 个 程序 需要 哪些 技术 。 
2.2 程序 需求 及 初始 设置 


将 要 创建 的 聊天 程序 需要 完成 如 下 任务 : 

口 提供 静态 文件 ( 比如 HTML、CSS 和 客户 病 JavaScript ); 

口 在 服务 套 上 处 理 与 聊天 相关 的 消 县 ; 

口 在 用 户 的 浏览 各 中 处 理 与 聊天 相关 的 消 朋 。 

为 了 提供 静态 文件 , 需要 使 用 Node 内 置 的 http 模 块 。 但 通过 HTTP 提 供 文 件 时 ,通常 不 能 只 
是 发 送 文 件 中 的 内 容 ， 还 应 该 有 所 发 送 文件 的 类 型 。 也 就 是 说 要 用 正确 的 MIME 类 型 设置 HTTP 
头 的 content-Type。 为 了 查找 这 些 MIME 类 型 ， 你 会 用 到 第 三 方 的 模块 mime。 

MIME 类 型 MIME 类 型 在 维基 百科 上 的 文章 http://en.wikipedia.org/wiki/MIME 中 有 
详细 论述 。 

为 了 处 理 与 聊天 相关 的 消息 ， 需 要 用 Ajax 轮 询 服务 融 。 但 为 了 让 这 个 程序 能 尽 可 能 快 地 做 出 
啊 应 ， 我 们 不 会 用 传统 的 Ajax 发 送 消息 。Ajax 用 HTTP 作 为 传输 机 制 ， 并 且 HTTP 本 来 就 不 是 做 实 
时 通信 的 。 在 用 HTTP 发 送 消 息 时 ， 必 须 用 一 个 新 的 TCP/ 耻 连接 。 打 开 和 关闭 连接 需要 时 间 。 此 
外 ， 因 为 每 次 请 求 都 要 发 送 HITP 头 ， 所 以 传输 的 数据 量 也 比较 大 。 这 个 程序 没 用 依赖 于 HTTP 
的 方案 ， 而 是 采用 了 WebSocket ( http://en.wikipedia.org/wiki/WebSocket )， 这 是 一 个 为 支持 实时 
通讯 而 设计 的 轻 量 的 双 回 通信 协议 。 

为 在 大 多 数 情 况 下 ， 只 有 兼容 HTML5 的 浏览 各 才 支 持 WebSocket， 所 以 这 个 程序 会 使 用 流 
行 的 Socket.IO 库 ( http://socket.io/ )， 它 给 不 能 使 用 WebSocket 的 浏览 器 提 供 了 一 些 后 备 措 施 ， 包 
括 使 用 Flash。SocketIO 对 后 备 功能 的 处 理 是 透明 的 ， 不 需要 额外 的 代码 或 配置 。 第 13 草 对 
Socket.IO 做 了 更 深入 的 介绍 。 

在 开始 做 程序 的 文件 结构 和 依赖 项 设置 这 些 真 正 的 初期 工作 之 前 ,我 们 先 聊 聊 Node 如 何 同 时 
处 理 HTTP 和 WebSocket， 这 是 选 它 做 实时 程序 最 好 的 理由 之 一 。 























2.2.1 提供 HTTP 和 WebSocket 服 务 








尺 省 这 个 程序 不 会 用 Ajax 发 送 和 接收 聊天 消 奶 ， 但 它 仍 要 用 HTTP 发 送 用 在 用 户 浏 览 各 中 的 
HTML 、CSS 和 客户 端 JavaScript。 

如 图 2-5 所 示 ，Node 用 一 个 病 口 就 可 以 轻松 地 提供 HTTP 和 WebSocket 两 种 服务 。Node 市 有 一 
个 可 以 提供 HTTP 服 务 功 能 的 模块 。 还 有 一 些 第 三 方 的 Node 模 块 ， 比 如 构建 在 Node 内 置 功能 上 的 
Express， 它 让 Web 服 务 变 得 更 加 容易 了 。 我 们 将 在 第 8 草 深 入 探讨 如 何 用 Express 构 建 Web 程 序 。 
然而 在 本 章 的 程序 中 ， 还 是 以 介绍 基础 知识 为 主 。 
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Web 浏 览 器 Web 浏 览 吕 一 


HTTP WebSocket WebSocket 
员 应 数据 发 壕 数据 接收 








Node 服 务 硕 一 





本 | | 山石 日 ) 1] 访 9] 利 | 大 下 所 网 站 四 


图 2-$ 在 一 个 程序 中 处 理 HTTP 和 WebSocket 


现在 你 对 程序 要 用 的 核心 技术 已 经 有 了 大 概 的 认识 ， 证 我 们 把 它 充实 起 来 。 


需要 安装 Node 了 吗 ? 
如 果 你 还 没 装 Node， 请 翻 到 本 书 附录 A， 遵 照 其 中 的 指令 安装 。 


2.2.2 创建 程序 的 文件 结构 


在 开始 这 个 教程 前 , 我 们 先 为 它 创 建 一 个 项 目 目录 。 主 程序 文件 会 直接 放 在 这 个 目录 下 。 你 
需要 添加 一 个 1ib 子 目录 , 用 来 放 一 些 服 务 端 逻辑 。 还 需要 创建 一 个 public 子 目录 , 用 来 放 客 户 
端 文件 。 在 public 子 目录 下 ， 创 建 一 个 javascripts 子 目录 和 一 个 stylesheets 目 录 。 

现在 你 的 目录 结构 看 起 来 应 该 像 图 2-6 一 样 。 注 意 ， 我 们 决定 在 本 章 中 用 这 种 特别 的 方式 组 
织 程序 中 的 文件 .Node 对 目录 结构 没有 任何 特殊 要 求 ,你 可 以 根据 目 己 的 喜好 随意 组 织 程序 文件 。 


AMNA [chatrooms 一 
4 items, 15.07 GB available 
Name 
”i lib 
” 上 public 
™ BB javascripts 
”9 stylesheets 
































==== 4 
图 2-6 ”聊天 程序 项 目 目录 结构 
现在 你 已 经 确立 了 程序 的 目录 结构 ， 接 下 来 该 指明 它 的 依赖 项 了 。 
程序 的 依赖 项 ,在 这 里 是 指 需要 通过 安装 , 来 提供 程序 所 需 功能 的 模块 。 这 么 说 吧 ， 比 如 你 
正在 创建 的 程序 需要 访问 存放 在 MySQL 数 据 库 中 的 数据 ， 可 Node 中 没有 可 以 访问 MySQL 的 内 置 
模块 ， 所 以 你 只 能 装 一 个 第 三 方 模块 ， 这 个 模块 就 是 我 们 所 说 的 依赖 项 。 


2.2.3 指明 依赖 项 
尽管 不 正式 指明 依赖 项 也 可 以 创建 Node 程 序 , 但 花 点 时 间 明 确 一 下 是 个 好 习惯 。 这 样 , 如果 
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其 他 人 要 使 用 你 的 程序 ， 或 者 你 计划 在 多 个 地 方 运行 它 时 ， 设 置 起 来 就 要 人 简单 直接 得 多 。 

程序 的 依赖 项 是 在 package.json 文 件 中 指明 的 。 这 个 文件 总 是 被 放 在 程序 的 根 目 录 下 。 
package.json 文 件 用 于 描述 你 的 应 用 程序 ， 它 包含 一 些 JSON 表 达 式 ， 并 膛 循 CommonJS 包 摘 述 标 
准 ( http://wiki.commonjs.org/wiki/Packages/1.0 )。 在 package.json 文 件 中 可 以 定义 很 多 事情 ， 但 最 
重要 的 是 程序 的 名 称 、 版 本 号 、 对 程序 的 描述 ， 以 及 程序 的 依赖 项 。 

代码 清单 2-1 中 是 一 个 包 描 述 文件 ， 描 述 了 这 个 培训 程序 的 功能 和 依赖 项 。 将 这 个 文件 保存 
到 培训 程序 的 根 目录 中 ， 命 名 为 package.json。 


代码 清单 2-1 包 描 述 文件 
{ 


"name": "chatrooms'", < 一 包 名 称 
"version": "0.0.1", 




















"description": "Minimalist multiroom chat server", 
"dependencies": { < 一 包 的 依赖 项 
"socket.io": "~0.9.6", 
"mime": "~1.2.7" 
} 
} 


如 果 你 看 不 太 懂 这 个 文件 ， 不 要 担心 ， 下 一 章 还 会 介绍 packagejson 文 件 ， 并 且 在 第 14 章 还 
会 深入 探讨 它 。 


2.2.4 ”安装 依赖 项 


定义 好 package.json 文 件 之 后 ， 安 法 程 序 的 依赖 项 就 是 小 末 一 人 碟 了 。Node 包 管理 各 (npm， 
https://github.conmy/isaacs/npm ) 是 Node 目 囊 的 工具 ， 它 有 很 多 功能 ， 可 以 轻松 安装 第 三 方 Node 模 
块 ， 可 以 把 你 自己 创建 的 任何 Node 模 块 向 全 球 发 布 。 它 用 一 行 命令 就 能 从 package.json 文 件 中 读 
出 依赖 项 ， 把 它们 都 装 好 。 

在 教程 的 根 目录 下 输入 下 面 这 条 命令 : 

npm install 

再 看 这 个 目录 , 你 应 该 能 看 到 一 个 新 创建 的 node modules 目 录 ， 如 图 2-7 所 示 。 这 个 目录 中 放 
的 就 是 程序 的 依赖 项 。 




















HNO chatapplication OO 
6 items, 12.83 GB available 
Name 
> a lib 
™ BD node_modules 
> [a mime 
> | socket.io 
package.json 
> (Wl public 
ES 4 


图 2-7“” 当 用 npm 安 装 依 赖 项 时 ， 会 创建 一 个 新 的 node_ modules 目 录 
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目录 结构 已 经 确立 了 ， 依 赖 项 也 效 好 了 ， 可 以 开始 填充 程序 逻辑 了 。 


2.3 提供 HTML、CSS 和 客户 端 JavaScript 的 服务 


就 像 之 前 列 出 来 的 ， 聊 天 程序 需要 具备 三 个 基本 功能 : 

口 给 用 户 的 Web 浏 览 硕 提供 静态 文件 ; 

口 在 服务 疾病 处 理 与 聊天 相关 的 消息 ; 

口 在 用 户 的 web 浏览 六 中 处 理 与 聊天 相关 的 消 且 。 

程序 的 逻辑 是 由 一 些 文件 实现 的 ， 有 些 运 行 在 服务 融 上 ， 有 些 运行 在 客户 端 ， 如 网 2-8 所 示 。 
在 客户 问 运 行 的 JavaScript 需 要 作为 静态 资源 发 给 浏览 瘟 ， 而 不 是 在 Node 上 执行 。 


本 二 二 
Server.js 


A i lib 


(Node.js) 
index.html 


一 
| stylesheets 


客户 端 ” .-. 


(Web 浏 览 器 ) 




















= 
| javascripts 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 





ee 


图 2-8 ”这 个 聊天 程序 中 既 有 客户 端 JavaScript 逻 辑 ， 也 有 服务 端 JavaScript 迎 辑 


本 方 要 先 解 决 第 一 个 需求 ， 我们 会 定义 提供 静态 文件 所 需 的 迎 辑 。 人 然后 添加 静态 的 HTML 和 
CSS 文 件 。 
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2.3.1 创建 静态 文件 服务 器 


创建 静态 文件 服务 需 既 要 用 到 Node 内 置 的 功能 ， 也 要 用 第 三 方 的 mime 附 加 模块 来 确定 文件 
的 的 MIME 类 型 。 

先 从 程序 的 主 文件 开始 ， 请 在 项 目 根 目录 下 创建 serverjs 文 件 ， 把 代码 清单 2-2 中 的 变量 声明 
放 到 这 个 文件 中 。 有 了 这 些 声明 ， 你 就 可 以 使 用 Node 中 跟 HTTP 相 关 的 功能 、 跟 文件 系统 交互 的 
功能 ， 以 及 确定 文件 MIME 类 型 的 功能 。 变 量 cache 是 用 来 缓存 文件 中 的 数据 的 。 


代码 清单 2-2 ”变量 声明 

















W000 内 置 的 http 模 块 提供 了 HTTP 服 务 

内 置 的 path [Var fs = require('fs'),; 器 和 客户 端 功 能 

模块 提供 了 , 内 置 的 http 模 块 提供 了 HTTP 服 务 

Var path = require('path'); ES 

与 文件 系统 器 和 客 尸 端 功能 

名 径 相关 芯 J 

0 相关 的 Var mime = require( 'mime').;， 附加 的 mime 模 块 有 根据 文件 扩展 名 
0 得 出 MIME 类 型 的 能 





i 

1. 发 送 文件 数据 及 错误 响应 

接 下 来 要 添加 三 个 辅助 水 数 以 提供 静态 HTTP 文 件 服务 。 第 一 个 是 在 所 请 求 的 文件 不 存在 时 
发 送 404 错 误 的 。 把 下 面 的 辅助 师 数 加 到 serverjs 中 : 


function senad404(resPonse) { 





response.writeHead{(404, {'Content-Type': 'text/plain'}).; 
response.writel'Error 404: resource not found.'). 





response.endl(); 


} 
第 二 个 辅助 函数 提供 文件 数据 服务 。 这 个 驮 数 先 写 出 正确 的 HITP 头 ,然后 发 送 文件 的 内 容 。 
把 下 面 的 代码 添加 到 server.js 中 : 


function sendFrile(response, filePath, fileContents) { 
response.writeHeag! 
200,， 
{"'content-type": mime.lookup (path.basename (filePpathn))} 
Ey 
response.end{(fileContents); 


} 

访问 内 存 (RAM ) 要 比 访 问 文件 系统 快 得 多 ， 所 以 Node 程 序 通 常会 把 常用 的 数据 缓存 到 内 
存 里 。 我 们 的 聊天 程序 就 要 把 静态 文件 绥 存 到 内 存 中 ,只 有 第 一 次 访问 的 时 候 才 会 从 文件 系统 中 
读 取 。 下 一 个 辅助 函数 会 确定 文件 是 否 缓存 了， 如 果 是 ， 束 返 回 它 。 如 果 文 件 还 没 被 缓存 ， 它 会 
从 硬盘 中 谈 取 并 返回 它 。 如 果 文 件 不 存在 ， 则 返回 一 个 HTTP 404 错 误 作 为 啊 应 。 把 这 个 辅助 函 
数 加 到 server.js 中 : 
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代码 清单 2-3 ”提供 静态 文件 服务 


function ServeStatlcl(zespPonse，cache，absPathnh) f{ | 检查 文件 是 否 缓存 在 内 存 中 
if (cache[labsPath]) { 
sendFile(response, absPath, cachel[labsPathl]).; < 一 从 内 存 中 返回 文件 
} else { 
fs.exists(absPath, function(exists) { < 一 检查 文件 是 否 存在 


if (exists) { 
fs Fedadrile(alsrath, functicnt(err, aca) | < 一 从 硬盘 中 读 取 文件 
if (err) { 
send404 (response); 


} else { 
cachelabsPath] = data; 
sendFile(response, absPath, data).; 
时 9 
} else { 
send404 (response).; | 
] 发 送 HTTP 404 响 应 


了 
} 
} 


2. 创建 HTTP 服 务 器 

在 创建 HITP 服 务 需 时 ， 需 要 给 createServer 传 人 一 个 匿名 男 数 作为 回调 吨 数 ， 由 它 来 处 
理 每 个 HTTP 请 求 。 这 个 回调 函数 接受 两 个 参数 : request 和 response。 在 这 个 回调 执行 时 ， 
HTTP 服 务 硕 会 分 别 组 猴 这 两 个 参数 对 象 , 以 便 你 可 以 对 请 求 的 细 布 进行 处 理 , 并 返回 一 个 啊 应 。 
第 4 章 会 深入 介绍 http 模 块 。 

将 下 面 代码 清单 中 的 逻辑 添加 到 serverjs 中 以 创建 HTTP 服务 需 。 


代码 清单 2-4 创建 HTTP 服 务 器 的 逻辑 

















ar server = http.createServer (function(regquest, response 
Var filePpath = false; 上 网 
2 ， 用 匿名 函数 
if (eduegst ,url == '*/"}) 1 四 大 ， 定义 对 每 个 请 求 
filepath = 'public/index.html'; 确定 返回 的 默认 HTML 文 件 的 处 理 行为 
} else { 
| filePpath = 'public' + request.url; 将 URL 路 径 转 为 文件 
的 相对 路 径 
var absPath = './' + filepath; 
serveStatic (response, cache, abspPpath).; < 一 返回 静态 文件 


}); 

3. 启动 HTTP 服 务 器 

现在 你 已 经 写 好 了 创建 HTTP 服 务 妖 的 代码 , 但 还 没 添加 启动 它 的 逻辑 。 添加 下 面 这 些 代 码 ， 
它 会 启动 服务 器 ,要 求 服务 器 监听 TCP/P 端 口 3000。3000 是 随便 选 的 ,所 有 1024 以 上 的 未 用 端口 
应 该 都 可 以 (如 果 在 Windows 上 运行 ，1024 以 下 的 端口 也 行 ， 或 者 在 Linux 及 OS X 中 用 “root ”这 
样 的 特权 用 户 启动 程序 也 可 以 )。 
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server.listent{3000, functiont) f{ 
Console.log{t"Server listening on Dort 3000."); 


I 


如 果 你 想 看 看 这 个 程序 现在 能 做 什么 ， 可 以 在 命令 行 中 输入 下 面 这 条 命令 司 动 服务 天 


node server.js 

服务 器 运行 起 来 后 ,在 浏览 器 中 访问 http://127.0.0.1:3000 会 激发 404 错 误 辅 助 函 数 ， 页面 上 会 
显示 “Error 404: resource not om 消息 。 尽 管 你 已 经 添加 了 静态 文件 处 理 逻 辑 ， 但 还 没 添 加 
那些 静态 文件 。 记 住 ， 在 命令 行 中 按 下 Ctrl-C 可 以 停止 正在 运行 的 服务 器 

接 下 来 ， 让 我 们 把 必须 的 闹 态 文件 加 上 ， 把 这 个 聊天 程序 的 功能 再 向 前 推进 一 步 。 














2.3.2 ”添加 HTML 和 和 CSS 文件 


你 要 加 的 第 一 个 静态 文件 是 默认 的 HTML 文 件 。 在 public 上 日 录 下 创建 index.html 文 件 ， 把 代码 
清单 2-5 中 的 HTML 放 进去 。 这 段 HTML 会 引入 一 个 CSS 文 件 , 设置 一 些 显示 程序 内 容 的 div 元 素 ， 








加 载 一 些 客户 端 JavaScript 文 件 。 这些 JavaScript 文 件 提供 了 客户 端 Socket.IO0 功 能 、jQuery ( 用 来 操 





作 DOM )， 以 及 两 个 该 程序 特有 的 文件 ， 用 来 提供 聊天 功能 。 
代码 清单 2-5 ”聊天 程序 的 HTML 


<!ldoctype html> 
<html lang='en'> 


<head> 
<title>Chat</title> 
<link rel='stylesheet' href='/stylesheets/style.css'></link> 
</head> 
0 显示 当前 聊天 室 
<div id='content'> 名 称 的 div 
<div id='room'></div> 


<div id='room-list'></div> 


显示 当前 可 <div id='messages'></div> "| 
YL 
ss ~ 自 人 站 
用 聊天 室 列 <form id='send-form'> 显示 聊天 消息 的 aiv 
表 的 aiv <input id='send-message' /> 
<input id='send-button' type='submit' value='Send'/> 用 户 用 来 输入 聊 
a 天 命令 和 消息 的 
<div id='help'> 一 
表单 输入 元 素 


Chat commands: 
< > 
<l1li>Change nickname: <code>/nick [username]</code></1i> 
<1i>Join/create room: <code>/join [room namel]</code></11i> 
</ul> 
</div> 
</form> 
</dliv> 
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<script src='/socket.io/socket.1i0.js' type='text/jJavascript'></script> 

<script src='http://code.jquery.com/jquery-1.8.0.min.js' 
type='text/javascript'></script> 

<script src='/javascripts/chat.js' type='text/javascript'></script> 

<script src='/javascripts/chat ui.js' type='text/javascript'></script> 

</body> 

</htmil> 


下 一 个 要 添加 的 是 定义 程序 页 面 样式 的 CSS 文 件 。 在 public/stylesheets 目 录 下 创建 style.css 文 
件 ， 把 下 面 的 CSS 代 码 放 进去 。 


代码 清单 2-6 程序 的 CSS 


body 1{ 
padding: S50Opx; 
font: 14px "Lucida Grande", Helvetica, Arial, sans-serif; 


} 
a 1 
Color: #00BY7FF; 
} | 程序 界面 的 宽度 是 800p， 水 平 居 中 
#content { 


width: 800px; 
margin-left: auto; 
margin-right: auto; 
} 显示 当前 聊天 室 名 称 那个 区 域 的 CSS 规 则 
#room { 
background-color: #ddd; 
margin-bottom: lem; 
] | 显示 消息 的 区 域 宽 690p， 高 300p 
i#messages { 
width: 690px; 
height: 300px:; 
overflow: auto; 
Be en 让 显示 消息 的 区 域 在 内 容 填 满 后 可 以 向 下 滚动 
margin-bottom: lem; 
margin-right: 10px; 
} 


现在 HIML 和 CSS 基 本 做 好 了 , 运行 程序 , 用 浏览 需 看 一 下 , 应 该 能 看 到 如 图 2-9 所 示 的 界面 。 
这 个 程序 还 不 能 用 , 但 静态 文件 已 经 可 以 看 了 ,基本 的 视觉 布局 也 搭建 好 了 。 把 这 些 料 理 好 
了 之 后 ,我们 接 下 来 去 定义 服务 端 聊天 消息 的 分 发 。 
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HOQ Chat 
医 Chat [+| 
(4 ) @ 127.0.0.1:3000 © 区 中- cooole Q ) [会 | 
( Send ) 


Chat commands: 


e Change nickname: /nick [username] 
e Join/create room: /join [room name ] 





图 2-9 ”开发 中 的 程序 


2.4 用 Socket.IO 处 理 与 聊天 相关 的 消息 


我 们 前 面 说 过 程序 必须 要 做 三 件 事 , 其 中 第 一 个 提供 静态 文件 已 经 做 了 ,现在 来 解决 第 二 个 ， 
处 理 浏览 希 和 服务 顺 之 间 的 通信 。 现 代 浏 览 需 能 用 WebSocket 处 理 浏 览 需 跟 服务 需 两 者 之 间 的 通 
信人 参见 SocketIO 浏 览 融 文 持 页 以 了 解 详 情 : http://socket.io/#browser-support )。 

Socket.I0 为 Node 及 客户 问 JavaScript 提 供 了 基于 WebSocket 以 及 其 他 传输 方式 的 封装 , 它 提 供 
本 一 个 抽象 屋 。 如 果 浏 览 兹 没有 实现 WebSocket，Socket.IO 会 日 动 启用 一 个 备 选 方案 ， 而 对 外 提 
供 的 API 还 是 一 样 的。 本 节 将 会 : 

口 简要 介绍 下 SocketIO， 并 确定 要 在 服务 硕 端 使 用 的 Socket.IO 功 能 ; 

口 添 加 代码 设置 SocketIO 服 务 器 ; 

口 添 加 代码 处 理 各 种 聊天 程序 的 事件 。 

Socket.IO 提 供 了 开 箱 即 用 的 虚拟 通道 , 所 以 程序 不 用 把 每 条 消息 都 问 已 连接 的 用 户 广播 ,而 
是 只 回 那 些 预订 了 有 某 个 通道 的 用 户 广播 。 用 这 个 功能 实现 程序 里 的 聊天 室 非 常 简单, 很 快 你 就 能 
看 到 。 

Socket.IO 还 是 事件 发 射 闫 ( Event Emitter ) 的 好 例子 。 事 件 发 射 关 本 质 上 是 组 织 异 步 逮 辑 的 
一 种 很 方便 的 设计 模式 。 本 章 中 会 有 一 些 事件 发 射 硕 的 代 但 ， 但 下 一 章 才 会 做 更 次 入 的 讨论 。 
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> 
由 


事件 发 射 器 
事件 发 射 器 是 跟 某 种 资源 相关 联 的 , 它 能 向 这 个 资源 发 送 消息 ,也 能 从 这 个 资源 接收 消息 。 
源 可 以 连接 远程 服务 器 ， 或 者 更 抽象 的 东西 ， 比 如 游戏 中 的 角色 。Johnny-Five 项 目 


( https://github.com/rwldrn/johnny-five ) 是 一 个 用 Node 做 的 机 器 人 程序 ， 实 际 上 就 是 用 事件 发 射 
器 控制 Arduino 微 控制 器 。 





我 们 先 开 始 做 服务 骨 上 的 功能 ， 并 确立 处 理 连 接 的 逻辑 。 然 后 会 定义 服务 端 所 需 的 功能 。 


2.4.1 设置 Socket.IO 服 务 器 





首先 ， 把 下 面 这 两 行 代 三 添 加 到 server.js 中 。 第 一 行 加 载 一 个 定制 的 Node 模 块 ， 它 提供 的 逻 








辑 是 用 来 处 理 基 于 Socket.IO 的 服务 端 聊 天 功能 的 ， 我 们 在 后 文中 再 定义 这 个 模块 。 第 二 行 启 动 
Socket.IO 服 务 器 , 给 它 提供 一 个 已 经 定义 好 的 HTTP 服 务 器 , 这 样 它 就 能 跟 HTTP 服 务 器 共享 同一 
个 TCP/ 耻 端口 : 


var chatServer = requirel('./lib/chat server'); 
chatSserver.listen(server), 


现在 你 要 在 lib 目 录 中 创建 一 个 新 文件 ，chat_server.js。 先 把 下 面 的 变量 声明 添加 到 这 个 文件 








这 些 声 明 让 我 们 可 以 使 用 Socket.IO， 并 初始 化 了 一 些 定义 聊天 状态 的 变量 : 
Var socketio = require{('socket.10'); 

Var 1io; 

var guestNumber es 


; 
var namesUsed = 
Var CurrentRoom 


确立 连接 逻辑 
接 下 来 添加 代码 清单 2-7 中 的 逻辑 ,定义 聊天 服务 禹 也 数 1isten。serverjs 中 会 调用 这 个 函数 。 


Var nlickNames = {} 
[ 


人 





它 司 动 SocketIO 服 务 带 , 限定 SocketIO 回 控制 全 输出 的 日 志 的 详细 程度 , 并 确定 该 如 何 处 理 每 个 
接 进 来 的 连接 。 





你 应 该 注意 到 了 ,连接 处 理 逻 辑 调用 了 几 个 辅助 本 数 ,现在 你 可 以 把 它们 添加 到 chat serverjs 中 。 


代码 清单 2-7 ”局 动 Socket.IJO 服 务 需 


exports.listen = function(server) { 
10 = socketio.listen(server).; 
启动 Socket. 

IO 服 务 器 io.set('log level', 1); 定义 每 个 用 
FI HAF? ， 、 ss 
允许 它 搭载 

在 已 有 的 io.Sookets, on('connection', function (gocket) + 理 逻 辑 
a 服务 uestNumber = BaselionGuestName (sooket, guestNumber; 在 用 户 连 接 上 来 时 
Ee nickNames, namesUsed); 赋予 其 一 个 访客 名 
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joinRoom(socket, 'Lobby'); 


在 用 户 连 接 上 
handleMessageBroadcasting(socket, nickNames); 处 理 用 户 的 消息 ， 
里 handleNameChangeAttempts (socket, nickNames, namesUsed); 更 名 , 以 及 聊天 室 


的 创建 和 变更 





handleRoomJoining (socket).; 


socket.on('rooms', function() { 用 户 发 出 请 求 时 ， 向 
socket.emit('rooms', io.sockets.manager.rooms).; 其 提供 已 经 被 占用 的 
聊天 室 的 列表 


}); 


bs 连接 后 的 清除 


handleClientDisconnection(socket, nickNames, namesUsed).; 定义 用 户 断 开 
| 逻辑 


}; 
我 们 已 经 确立 了 连接 处 理 逻 辑 ， 现 在 该 座 加 用 来 处 理 程序 需求 的 所 有 辅助 函数 了 。 


2.4.2 ”处 理 程序 场景 及 事件 


聊天 程序 需要 处 理 下 面 这 些 场景 和 事件 : 

口 分 配 昵称 ; 

口 房间 更 换 请 求 ; 

口 昵称 更 换 请 求 ; 

口 发 送 聊 天 消息 ; 

口 房间 创建 ; 

口 用 户 断 开 连 接 。 

要 实现 这 些 功 能 得 添加 几 个 辅助 水 数 ， 如 下 文 所 述 。 

1. 分 配 昵 称 

要 添加 的 第 一 个 辅助 函数 是 assignGuestName， 用 来 处 理 新 用 户 的 昵称 。 当 用 户 第 一 次 连 
到 聊天 服务 器 上 时 , 用 户 会 被 放 到 一 个 叫做 Lobby 的 聊天 室 中 , 并 调用 assignGuestName 给 他 们 
分 配 一 个 上 昵称， 以便 可 以 相互 区 分 开 。 

程序 分 配 的 所 有 昵称 基本 上 都 是 在 Guest 后 面 加 上 一 个 数字 ， 有 新 用 户 连 进来 时 这 个 数字 就 
会 往 上 增长 。 用户 昵称 存在 变量 nickNames 中 以 便于 引用 ,并 有 目 会 跟 一 个 内 部 socket ID 关联 。 昵 
称 还 会 被 添加 到 namesUsed 中 , 这 个 变量 中 保存 的 是 已 经 被 占用 的 昵称 。 把 下 面 清单 中 的 代码 添 
加 到 1lib/chat serverjs 中 实现 这 个 功能 。 
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代码 清单 2-8 分配 用 户 昵 称 


function assignGuestName (socket, guestNumber, nickNames, namesUsed) { 


Var name = 'Guest' + guestNumber 
4 nickNames[socket.id] = name; 

. 0 socket.emit('nameResult', { 让 用 户 知道 他 们 生成 新 昵称 
端 连接 ID ee 的 昵称 
关联 上 7 存放 已 经 被 占用 

namesUsed.push (name).; 的 昵称 

return guestNumber + 1; 增加 用 来 生成 昵 

} | 
称 的 计数 器 
进入 聊天 宇 


hi 到 chat_serverjs 中 的 第 二 个 辅助 函数 是 joinRoom。 这 个 函数 如 代码 清单 2-9 所 示 ， 处 
理 逻 辑 跟 用 户 加 入 聊天 室 相 关 。 


代码 清单 2-9 与 进入 聊天 室 相关 的 逻辑 





、 , function JoinRoom(socket, room) { 
0 socket .join(room),; < 一 ”让 用 户 进入 房间 
当 击 房间 currentRoom[socket.id] = room; 

socket.emit('joinResult', {room: room}); ee 
、 、 socket.broadcast.to(room) .emit('message', { | 让 用 户 知 道 他 们 
让 房间 里 的 人 进入 了 新 的 房间 
其 他 用 户 知 text: nickNames[socket.1d] + has Joined + IOOm + 
道 有 新 用 户 | 了) 
进入 了 房间 Var usersInRoom = io.sockets.clients (room); 

if (usersInRoom.length > 1) { 
2 Var We = 'Users currently in ' + room + ': 
ee for (var index in usersInRoom) { 
| 房间 里 ， Var USerSocketIQ = usersInRoom[index] .1d; 确定 有 了 哪些 用 户 
汇总 下 都 是 if (usezSocketIQ != socket.id) { 在 这 个 房间 里 
谁 if (index > 0) { 

usersInRoomSummary += ', ';) 
} 
usSersInRoomSummary += nickNames [userSocketId]; 
} 

} 。 

usersInRoomSummary += '.'; 汇总 发 送 给 这 个 用 户 

socket.emit('message', {text: usersInRoomSummary}) 


} 
} 


将 用 户 加 入 Socket.IO 房 间 很 价 单 ， 只 要 调用 socket 对 象 上 的 join 方法 就 行 。 然 后 程序 就 会 
把 相关 细 市 向 这 个 用 户 及 同一 房间 中 的 其 他 用 户 发 送 。 程序 会 让 用 户 知 道 有 哪些 用 户 在 这 个 房间 
里 ， 还 会 让 其 他 用 户 知道 这 个 用 户 进 来 了 。 

3. 处 理 昵 称 变更 请 求 

如 采用 户 都 用 程序 分 配 的 昵称 ， 很 难 记 住 谁 是 谁 。 因 此 聊天 程序 允许 用 户 发 起 更 名 请 3 
如 图 2-10 所 示 ， 更 名 需要 用 户 的 浏览 硕 通 过 Socket.IO 发 送 一 个 请 求 ， 并 接收 表示 成 功 或 失败 的 
响应 。 
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客户 端 发 送 带 有 字符 串 数据 
Web 浏 览 圳 Node 服 务 器 "Bob Dobbs" 的 nameAttempt 
事件 
. 六 返回 还 有 JSON 
Web 浏 览 器 Node 服 务 器 。 





{ 
success: true, 
name: name 





图 2-10 ”更 名 请 求 及 啊 应 


将 下 面 代 码 清单 中 的 代码 加 到 lib/chat server.js 中 , 这 段 代码 定义 了 一 个 处 理 用 户 更 名 请 求 的 
环 数 。 从 程序 的 角度 来 讲 ， 用 户 不 能 将 昵称 改 成 以 Guest 开 头 ， 或 改 成 其 他 已 经 被 占用 的 昵称 。 


代码 清单 2-10 更 名 请 求 的 处 理 逻 辑 


function handleNameChangeAttempts (socket, nickNames, namesUsed) { 











socket.on('nameAttempt', function(name) { 、 
if (name.indexOf ('Guest') == 0) { 添加 mameRAtte- 
socket.emit('nameResult', { | mpt 事 件 的 监听 器 
昵称 不 能 以 
、 success: false, 
Guest 开 头 message: Names cannot begin With "Guest",’ 
}); 如 果 昵 称 还 没 
SS 注册 就 注册 上 
if (namesUsed.indexOf (name) == -1) { 
Var previousName = nickNames [socket.id]; 
Var previousNameIndex = namesUsed.1indexOf (previousName).,; 
namesUsed.push (name).; 
nickNames[socket.1id] = name; 删 掉 之 前 用 的 昵称 ， 让 
delete namesUsed[lpreviousNameIndex]; 其 他 用 户 可 以 使 用 
SOCKet .emit('nameResult', f 
success: true, 
name: name 
ps 
socket.broadcast.to{({currentRoom[lsocket.1d])}.emit{'message', { 
text: previousName + ' iSs now KnNnOown as ' + Name + '.! 
Fs 
} else { 
socket.emit('nameResult', { 如 果 昵 称 已 经 * 
success: false, 未 必 称 已 经 被 三 用 ? 
message: 'That name 1S already in Use.， 给 客户 端 发 送 错误 消息 


上 
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4. 发 送 聊 天 消息 

用 户 了 昵称 没 问 题 了 , 现在 需要 加 个 函数 处 理 用 户 发 过 来 的 聊天 消息 。 图 2-11 给 出 了 基本 流程 : 
用 户 发 射 一 个 事件 ,表明 消息 是 从 哪个 房间 发 出 来 的 ,以 及 消息 的 内 容 是 什么 ; 然后 服务 带 将 这 
条 消息 转发 给 同一 房间 的 所 有 用 户 。 


客户 端 用 JSON 数 据 发 
浏览 器 A 过 来 的 message 事 件 


{ 
OG 车 eleleu 
text: Hi allv” 
! 

















服务 器 用 JSON 数 据 发 
过 来 的 message 事 件 


{ 
uD lao eo Do eet 


} 





图 2-11 ”发送 聊天 消息 





将 下 面 的 代码 加 到 lib/chat serverjs 中 。S$ocket.IO 的 broadqcast 困 数 是 用 来 转发 消息 的 : 


function handleMessageBroadcasting (socket) { 


Socket.on{'message', function (message) { 
socket.broadcast.to{(message.room) .emit!('message', 
text: nickNames[socket.id] + ': ' + message.text 
}); 
}7 3 
} 
5. 创建 房间 





接 下 来 要 添加 让 用 户 加 入 已 有 房间 的 逻辑 ， 如 果 房 间 还 没有 的 话 ， 则 创建 一 个 房间 。 图 2-12 
是 用 户 和 服务 硕 双 方 的 交互 。 
将 下 面 的 代码 旅 加 到 lib/chat_serverjs 文 件 中 ， 实 现 更 换 房 间 的 功能 。 注 意 SocketIO 中 leave 
方法 的 使 用 : 
function handleRoomJoining{(socket) 1{ 
socket.ont({'join', function(room) { 
socket.lJeave (currentRoom[lsocket.1id]): 
JolinRoom!(lsocket, room.newRoom).; 


}); 
} 
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| 客户 端 用 JSON 数 据 
浏览 器 Node 服 务 器 发 过 来 的 join 事件 


{ 


"NewroOom": "ROD"s RoOom" 





} 


一 | 服务 器 用 JSON 数 据 发 过 
浏览 来 的 jcinResult 事 件 


{ 
ODm po Poonm 


} 


图 2-12” 换 到 其 他 聊天 室 


6. 用 户 断 开 连 接 
最 后 还 要 把 下 面 这 段 代 码 添 加 到 1lib/chat serverjs 文 件 中 ， 当 用 户 离 开 聊 天 程序 时 ， 从 
nickNames 和 namesUsed 中 移 除 用 户 的 昵称 : 


function handleClientDisconnection(socket) { 
socket.on({'disconnect', function{() { 
Var nameIndex = namesUsed.indexOf (nickNames [socket.1id]),; 
delete namesUsedlnameTIndex]; 
delete nickNames [socket.1id]; 
1); 
} 


服务 端的 逻辑 都 已 经 做 好 了 ， 现 在 可 以 回 过 尖 去 继续 做 客户 端的 逻辑 了 。 


2.5 在 程序 的 用 户 界 面 上 使 用 客户 端 JavaScript 


在 服务 端 分 发 浏览 需 发 来 的 消息 的 Socket.IO 逻 辑 已 经 加 上 了 , 现在 该 添加 中 服务 需 通信 和 所 需 
要 的 客户 病 JavaScript 了 了。 客户 闹 JavaScript 需 要 实现 以 下 功能 : 

口 回 服务 硕 发 送 用 户 的 消 县 和 昵称 /房间 变更 请 求 ; 

口 显示 其 他 用 户 的 消 恩 ， 以 及 可 用 房间 的 列表 。 

我 们 先 从 第 一 个 功能 开始 。 


























2.5.1 将 消 县 和 昵称 /房间 变更 请 求 传 给 服务 器 


要 添加 的 第 一 段 客 户 端 JavaScript 代 人 码 是 一 个 JavaScript 原 型 对 象 ， 用 来 处 理 聊天 命令 、 发 送 
消息 、 请 求 变 更 房间 或 昵称 。 

在 public/javascripts 目 录 下 创建 一 个 chat.js 文 件 ， 把 下 面 的 代码 放 进 去 。 这 段 代码 相当 于 定义 
了 一 个 JavaScript“ 类 ”， 在 初始 化 时 可 用 传人 一 个 Socket.IO 的 参数 socket: 


var Chat = function(socket) { 
this.socket = socket,; 


}3 
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接 春 添加 这 个 发 送 聊 天 消息 的 函数 : 


Chat.prototype.sendMessage = functiontroom, text) { 
var message = 1{ 
room: room, 
text: text 
7 
this.socket.emit!('message', message),; 


] 








变更 房间 的 栖 数 : 
Chat .prototype.changeRoom = functionlroom) { 
this.socket .emit{({''jJoin', f{ 


newROom: IOOMm 
es 
} 3 


最 后 添加 下 面 代码 清单 中 定义 的 函数 ， 处 理 聊 天 命令 。 它 能 识别 两 个 命令 : join 用 来 加 入 


或 创建 一 个 房间 ，nick 用 来 修改 昵称 。 
代码 清单 2-11 人 处理 聊天 命令 


Chat .prototype.processCommand = function(command) f{ 
Var words = command.split(' '); 
var command = words{[0] 
.Substring(1, words[0] .length) 
.toLowerCase(); 人 第 一 个 单词 开始 
Var message = false; 0 


switch(command) { 
Case 'jJoin': 
words.shift().; 
Var room = words.jJoin(' '); 
Se ”| 处 理 房间 的 变换 /创建 
Case 'nick': 
words.shift().; 


Var name = words.join(' '); 

this.socket.emit('nameAttempt', name).; 

break; | 处 理 更 名 尝试 
default: 

message = 'Unrecognizeqd command.'; 

break:; 


如 果 命 令 无 法 识别 ， 


} ‘ = 
返回 错误 消息 


return message,; 


}; 


2.5.2 ”在 用 尸 界面 中 显示 消息 及 可 用 房间 


现在 该 添加 使 用 jQuery 跟 用 户 界 面 〈 基 于 浏览 硕 ) 直接 交互 的 逻辑 了 。 要 添加 的 第 
是 显示 文本 数据 。 
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从 安全 角度 来 看 ，Web 程 序 中 有 两 种 文本 数据 。 一 种 是 受信 的 文本 数据 ， 由 程序 提供 的 文本 
组 成 , 男 一 种 是 可 疑 的 文本 数据 ,是 由 程序 的 用 户 创 建 的 文本 , 或 从 用 户 创建 的 文本 中 提取 出 来 
的 。 我们 之 所 以 认为 来 自用 户 的 文本 数据 是 可 疑 的 , 是 因为 恶意 用 户 可 能 会 琴 意 在 提交 的 文本 数 
据 中 包含 <script> 标 签 ， 放 入 JavaScript 逻 辑 。 如 果 不 经 修改 就 把 这 些 数据 展示 给 其 他 用 户 ， 可 
能 会 发 生 令 人 厌恶 的 事情 ， 比 如 将 用 户 转 到 其 他 Web 页 面 上 。 这 种 支持 Web 程 序 的 方法 称 作 跨 域 
脚本 (XSS ) 攻击 。 

这 个 聊天 程序 会 用 两 个 辅助 郧 数 显 示 文 本 数据 。 一 个 函数 用 来 显示 可 疑 的 文本 数据 , 男 一 个 
哨 数 显示 受信 的 文本 数据 。 

咕 数 divEscapedContentElement 用 来 显示 可 疑 的 文本 。 它 会 净化 文本 ， 将 特殊 字符 转换 
成 HTML 实 体 ， 如 图 2-13 所 示 ， 这 样 浏览 絮 就 会 按 输入 的 样子 显示 它们 ， 而 不 会 试图 按 HTML 标 
签 解释 它们 。 


















































<script>alert('XSS8 attack!'});</script> 








divEscapedContentElement 


净化 并 放 在 <aiv> 元 素 中 的 销 县 





了 








<div>&It;script&gt ;alert{'XSS attack!');&Lt: /script&kgt ;<divy> 





图 2-13” 转 义 可 疑 内 容 





阴 数 divSsys temContentEl ement 用 来 显示 系统 创建 的 受信 内 容 ， 而 不 是 其 他 用 户 创建 的 o 
在 public/javascripts 目 录 下 创建 chat ui.js 文 件 ， 并 把 下 面 两 个 辅助 函数 放 进 去 : 


function divEscapedContentElement messace) { 
return S$S{'<div></div>') .text lmessage).; 


} 


function GQiveystemContentElement (message) { 
return S('<div></Qiv>') .html('<i>' + message + '</i>').， 


) 

下 一 个 要 加 到 chat uijs 中 的 函数 是 用 来 处 理 用 户 输入 的 ， 具 体内 容 见 代码 清单 2-12。 如 采用 
户 输 入 的 内 容 以 和 料 杠 〈 / ) 开头 ， 它 会 将 其 作为 聊天 命令 处 理 。 如 果 不 是， 就 作为 聊天 消息 发 送 
给 服务 郁 并 广播 给 其 他 用 户 ， 并 深 加 到 用 户 所 在 聊天 室 的 聊天 文本 中 。 


代码 清单 2-12 处理 原始 的 用 户 输 入 


function processUserIinput (chatApp, socket) { 





Var message = $('#send-message') .val (); . 

var systemMessage; 如 果 用 户 输 入 的 内 容 以 斜 杠 〈/) 
开头 ， 将 其 作为 聊天 命令 

if (message.charAt (0) == '/') { 


图 灵 社区 会 员 quqingtao 专 享 尊重 版 权 


32 ”第 2 章 构建 有 多 个 房间 的 聊天 室 程序 


systemMessage = chatApp.pProcessCommand (messagel).; 
if (systemMessage) { 

sl{'#tmessages') .append (diveSystemContentElement (systemMessage)).: 
} 

} else { 将 非 命令 输入 广播 给 
chatApp.sendMessage($('#room') .text(), message); 其 他 用 户 
S$S('#¥messages') .append (divEscapedContentElement (message)); 
S('#messages') .scrollTop($S('#messages') .prop('scrollHeight')); 

} 

Ss{'#send-message'} .val{'');: 


} 

辅助 函数 现在 已 经 定义 好 了 , 你 还 需要 添加 下 面 这 个 代码 清单 中 的 逻辑 , 它 要 在 用 户 的 浏览 
锅 加 载 完 页 面 后 执行 。 这 段 代 码 会 对 客户 端的 Socket.IO 事 件 处 理 进 行 初始 化 。 
代码 清单 2-13 ”客户 端 程序 初始 化 逻辑 


var Socket = 1o.connect () : 











Ss(document) .ready (function() { 
var chatApp = new Chat (socket).; 


| 显示 更 名 尝试 的 结果 
) { 


socket.on('nameResult', function(result 
Var message; 


jf (result.success) { 


message = 'You are now know as ' + result.name + '.'; 
} else 1 
message = result.message; 
】 
sl{'Htmessages') .append(divSsystemContentElement (messade) ) 
}); 
a . 显示 房间 变更 结 
socket.on('jJoinResult', function(result) { ,| 泵 房间 要 更 结 妥 
$('#room') .text (result.room).; 
$('#messages') .append (divSystemContentElement('Room changed.')); 
1 
socket.on('message', function (message) { 
ar newElement = '<div></div>') .text (message.text).,; i Sis 
er 0 J 显示 接收 到 的 消息 
$('#messages') .append (newElement).; 
py 
socket.on('rooms', function(rooms) { 


$('#¥room-list') .empty(); 显示 可 用 房间 列表 


for(var room in rooms) { 


zoom = room.substring(1, room.length); 
if (room != '') { 
$('#room-list') .append (divEscapedContentElement (room) ) ; 
} 
} 0 
信 卓 
S$('#room-list div') .click(function() { 房间 中 
chatApp.processCommand('/jJoin ' + S$S(ths) .text() ) ， 
$('#send-message') .focus(); 
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}); 


yg | 定期 请 求 可 用 房间 列表 
setIinterval (function() { 

socket.emit('rooms'); 
}, 1000); 
$s('#send-message') .focus(); | 提交 表单 可 以 发 送 聊 天 消息 
S$('#send-form') .submit (function() { 


processUserIinput (chatApp, socket).; 
return false; 
3 
人 


接 下 来 让 我 们 把 程序 做 完 ， 将 下 面 代 人 码 清单 中 的 CSS 样 取代 人 码 座 加 到 public/stylesheets 
/style.css 文 件 中 。 


代码 清单 2-14 ”最 后 一 点 要 加 到 style.css 中 的 代码 


#room-list { 
float: right; 
width: 100px:; 
height: 300px; 
overftlow: auto; 


} 








#room-~-list diwv f 
border-bottom: lpx solid #¥eee; 


} 


#room~list div:hover 1{ 
background-color: #ddd:; 


] 


tsend-message { 
width: 700px; 
margin-bottom: lem; 
margin-right: lem; 
} 
Hhelp { 
font: 1i0px "Lucida Grande", Helvetica, Ariaj, sans-serif; 


} 
加 好 最 后 的 代码 ， 让 我 们 把 程序 跑 起 来 试 试 ( 用 node server .js )。 结 果 看 起 来 应 该 像 
图 2-14 一 样 。 
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aNMN Chat 
知 Chat | 一 | | 
(< ) @ 127.0.0.1:3000 © RS Coogle Q [会 | 
、 
Basement 
Room changed. Basement 
You are now known as Guestl1. Lobby 


You are now known as Bob Dobbs. 

Room changed. 

Guest2: Hey Bob. Have you heard the ancient eagle's song? 

Alice: Hi Bob! 

No, Guest2, | have not heard that song. Although sometimes | imagine that | have. 


| Ge 


Chat commands: 


e。 Change nickname: /nick [username] 二 
e joinycreate room: /join [room name ] 





图 2-14 ”做 完 的 聊天 程序 


2.6 小结 


你 已 经 用 Node.js 完 成 了 一 个 小 型 的 实时 Web 程 序 ! 

对 于 如 何 构 建 程序 ， 以 及 代码 看 起 来 应 该 是 什么 样子 , 你 现在 应 该 有 点 感觉 了。 如果 对 这 个 
示例 程序 的 某 些 方面 仍 不 清楚 , 请 不 要 担心 , 我 们 在 后 续 草 节 中 会 深信 探 讨 这 个 例子 中 用 到 的 工 
乞 和 技术 。 

然而 在 深入 到 Node 的 具体 开发 工作 中 之 前 ,我 们 应 该 先 学 一 学 如 何 应 对 异步 开发 囊 来 的 独特 
挑战 。 下 一 章 将 教 给 你 一 些 基 本 的 技术 和 技巧 ， 这 能 帮 你 节省 大 量 时 间 ， 少 走 很 多 寄 路 。 
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本 章 内 容 

口 用 模块 组 织 代码 

口 编码 规范 

口 用 回调 处 理 一 次 性 完结 的 事件 
口 用 事件 发 射 器 处理 重 复 性 事件 
口 实现 串 行 和 并 行 的 流程 控制 
口 使 用 流程 控制 工具 


Node 不 像 大 多 数 开 源 平 台 那 样 , 它 很 容易 设置 , 对 内 存 和 硬盘 空间 没有 过 多 要 求 。 也 不 需要 
复杂 的 集成 开发 环境 或 构建 系统 。 但 掌握 一 些 基 础 知识 对 你 的 起 步 会 有 很 大 帮助 。 本 章 要 解决 
Node 开 发 新 手 要 面 对 的 两 个 难题 : 

口 如 何 组 织 代码 ; 

口 怎么 做 异步 编程 。 

大 多 数 经 验 丰 军 的 程序 员 都 非常 丈 悉 组 织 代 但 的 问题 。 按 照 概念 将 逻辑 组 织 成 类 和 因 数 。 将 
包含 类 和 函数 的 文件 组 织 到 源码 树 的 目录 中 。 最 后 代码 被 组 织 到 程序 和 库 中 。Node 的 模块 系统 提 
供 了 强大 的 代码 组 织 机 制 ， 本 和 草 就 要 教 你 如 何 利 用 它 组 织 代码 。 

要 领会 和 掌握 异步 编程 可 能 需要 花 些 时 间 。 你 对 程序 逻辑 应 该 如 何 执行 的 认识 要 有 模式 上 的 
转变 。 在 同步 编程 中 , 你 在 写 下 一 行 代 人 码 时 就 知道 它 前 面 的 所 有 代码 都 会 完 于 它 执行 。 然 而 在 异 
步 开 发 中 ， 程 序 逻 辑 乍 一 看 可 能 就 像 鲁 贝 ， 蕊 德 堡 机 ( Rube Goldberg machine ) 一 样 复杂 而 又 背 
稿 。 俗 话说， 麻 刀 不 误 砍 柴 工 ， 在 开始 开发 大 型 项 目 之 前 ， 应 该 学 一 下 怎么 才能 优雅 地 控制 程序 
的 行为 。 

本 章 会 介绍 几 种 重要 的 异步 编程 技术 ， 让 你 能 牢 牢 地 控制 程序 将 如 何 执行 。 你 将 学 到 : 

口 如 何 啊 应 一 次 性 事件 ; 

口 如 何人 处 理 重 复 性 事件 ; 

口 如 何 让 异步 逻辑 顺序 执行 。 

然而 我 们 要 先 讲 一 下 如 何 用 模块 解决 代码 组 织 的 问题 ,模块 是 Node 让 代码 易于 重用 的 一 种 组 
织 和 包 疙 方式 。 
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3.1 Node 功能 的 组 织 及 重用 

在 创建 程序 时 , 不 管 是 用 Node 还 是 什么 , 经 常会 出 现 不 可 能 把 所 有 代码 放 到 一 个 文件 中 的 
况 。 当 出 现 这 种 情况 时 ,传统 的 方式 是 按 逻 辑 相 关 性 对 代码 分 组 , 将 包含 大 量 代 人 码 的 单个 文件 
解 成 多 个 文件 ， 如 图 3-1 所 示 。 





情 
分 














所 有 代码 都 在 一 个 文件 中 相关 的 逻辑 一 起 放 在 单独 的 文件 中 
Utilities 
me index.js -| lib/utilityFunctions.js 
Utilities | ee poaop 
Commands 
ee Commands 





index.js - lib/commands.js 


图 3-1 用 目录 和 单独 的 文件 组 织 起 来 的 代码 找 起 来 要 比 整个 程序 代码 部 放 在 一 个 
长 文件 中 找 起 来 更 容易 


在 茶 些 语言 的 实现 中 ， 比 如 PHP 和 Ruby， 整 合 为 一 个 文件 ( 我 们 称 之 为 “included” 文 件 ) 
中 的 逻辑 , 可 能 意味 着 在 被 引入 文件 中 执行 的 逻辑 会 影响 全 局 作用 域 。 也 就 是 说 被 引入 文件 创建 
的 任何 变量 ， 以 及 声明 的 任何 函数 都 可 能 会 覆盖 包含 它 的 应 用 程序 所 创建 的 变量 和 声明 的 函数 。 

假设 你 用 PHP 写 程序 ， 你 的 程序 中 可 能 会 有 下 面 这 种 逻辑 : 

function uppercase trim{stext)} { 

return trim(strtoupper (Stext}))}); 

} 

LIncluael' strIno_hanadlers.Dhp ' ) ; 

如 果 string handlers.php 文 件 也 定义 了 一 个 uppercase_trim 哨 数 ， 你 会 收 到 一 条 蚀 误 消息 : 























Fatal error: Cannot redeclare uppercase trim!() 
在 PHP 中 可 以 用 命名 空间 避免 这 个 问题 , 而 Ruby 通 过 模块 提供 了 类 似 的 功能 。 可 Node 的 做 法 
是 不 让 你 有 机 会 在 不 经 意 间 污染 全 局 命名 空间 。 

PHP 命 名 空间 和 Ruby 模 块 PHP 命 名 空间 在 它 的 手册 上 有 相关 论述 : http://php.net/ 
manual/en/language.namespaces.php。 Ruby 模 块 在 Ruby 文 档 中 有 解释 说 明 : www.ruby- 
doc.org/core-1.9.3/Module.html 
Node 模 块 打包 代码 是 为 了 重用 , 但 它们 不 会 改变 全 局 作用 域 。 比 如 说 , 假设 你 正 用 PHP 开 发 

一 个 开源 的 内 容 管 理 系 统 ( CMS )， 并 且 想 用 一 个 没有 使 用 命名 空间 的 第 三 方 API 库 。 这 个 库 中 
可 能 有 一 个 跟 你 的 程序 中 同名 的 类 ,除非 你 把 目 己 程序 中 的 类 名 或 者 库 中 的 类 名 给 改 了 ，, 否则 这 
个 类 可 能 会 搞 志 你 的 程序 ,可 是 修改 你 的 程序 中 的 类 名 可 能 会 让 那些 以 你 的 CMS 为 基础 构建 项 目 
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的 开发 人 员 遇 到 问题 。 如 果 你 选择 修改 那个 库 中 的 类 名 ，, 那么 你 每 次 更 新 程序 源码 树 中 的 那个 库 
时 都 得 记 着 再 改 一 次 。 命 名 冲突 问题 最 好 是 从 根本 上 了 予以 避免 。 

Node 模 块 允 许 你 从 被 引入 文件 中 选择 要 暴露 给 程序 的 困 数 和 变量 .如 果 模 块 返回 的 羡 数 或 变 
量 不 止 一 个 , 那 它 可 以 通过 设 定 exports 对 象 的 属性 来 指明 它们 。 但 如 有 果 模 块 只 返回 一 个 函数 或 
变量 ， 则 可 以 设 定 module.exports 属 性 。 图 3-2 展 示 了 这 一 工作 机 制 。 




















程序 模块 
requireg 模 块 
在 require 期 间 模块 逻辑 
返回 的 module .exp- 组 装 的 module.exports 
orts 或 exports module.exports 或 exportes 





expoOrts 















图 3-2” 组装 module .exports 属 性 或 exports 对 象 让 模块 可 以 选择 应 该 把 什么 跟 程 序 共享 


如 琳 你 觉得 有 点 军 ， 先 别 急 。 我 们 在 这 一 章 里 会 给 出 好 几 个 例子 。 

Node 的 模块 系统 避免 了 对 全 局 作用 域 的 污染 , 从 而 也 就 避免 了 命名 冲突 , 并 简化 了 代码 的 重 
用 。 模块 还 可 以 发 布 到 npm ( Node 包 管理 天 ) 存储 库 中 , 这 是 一 个 收集 了 已 经 可 用 并 且 要 跟 Node 
社区 分 至 的 Node 模 块 的 在 线 存 储 库 , 使 用 这 些 模块 没 必要 担心 朱 个 模块 会 窗 盖 其 他 模块 的 变量 和 
鹃 数 。 我 们 会 在 第 14 草 讨论 如 何 把 模块 发 布 到 npm 存 储 库 中 。 

为 了 玫 你 把 逻辑 组 织 到 模块 中 ， 我 们 会 讨论 下 面 这 些 主题 : 

口 如 何 创建 模块 ; 

口 模块 放 在 文件 系统 中 的 什么 地 方 ; 

口 在 创建 和 使 用 模块 时 要 意识 到 的 东西 。 

我 们 这 就 深信 到 Node 模 块 系统 的 学 习 中 去 ， 开 始 创 建 我 们 的 第 一 个 模块 。 


3.1.1 创建 模块 

模块 既 可 能 是 一 个 文件 ， 也 可 能 是 包含 一 个 或 多 个 文件 的 目录 ， 如 图 3-3 所 示 。 如 果 模 块 是 
个 目录 ，Node 通 常会 在 这 个 目录 下 找 一 个 叫 index.js 的 文件 作为 模块 的 人 口 〈 这 个 默认 设置 可 以 
重 写 ， 见 3.1.4 节 )。 


























;5 my_module.js I my_module 
1s| index.js 


图 3-3 ”Node 模块 可 以 用 文件 〈 例 1 ) 或 目录 ( 例 2 ) 创建 
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典型 的 模块 是 一 个 包含 exports 对 象 属性 定义 的 文件 , 这 些 属性 可 以 是 任意 类 型 的 数据 ， 比 
如 字符 串 、 对 象 和 函数 。 

为 了 演示 如 何 创 建 基 本 的 模块 ， 我 们 在 一 个 名 为 currency.js 的 文件 中 添加 一 些 做 货币 转换 的 
咀 数 。 这 个 文件 如 下 面 的 代码 清单 所 示 ， 其 中 有 两 个 吗 数 ， 分 别 对 加 元 和 美元 进行 互 换 。 
代码 清单 3-1 定义 一 个 Node 模 块 


Var canadianDollar = 0.91; 








function roundTwoDecimals (amount) { canadianToUS 函数 设 定 在 
return Math.round(amount * 100) / 100; 


exports 模 块 中 ， 所 以 引入 这 
} 个 模块 的 代码 可 以 使 用 它 


exports.canadianToUS = function(canadian) ({ 

return roundTwoDecimals (canadian * canadianDollar).: 
} USToCanadian 也 设 定 在 
exports.USToCanadian = function(us) { exports 模 块 中 


return roundTwoDecimals (us / canadianDollar).: 


} 

exports 对 象 上 只 设 定 了 两 个 属性 。 也 就 是 说 引入 这 个 模块 的 代码 只 能 访问 到 canadianToUS 
和 USToCanadian 这 两 个 子 数 。 而 变量 canadianDollar 作 为 私有 变量 仪 作用 在 canadianToUS 
和 USsTocanadian 的 逻辑 内 部 ， 程 序 不 能 直接 访问 它 。 

使 用 这 个 新 模块 要 用 到 Node 的 *equire 图 数 ， 该 郴 数 以 你 要 用 的 模块 的 路 径 为 参数 。Node 
以 同步 的 方式 寻找 它 ， 定 位 到 这 个 模块 并 加 载 文件 中 的 内 容 。 











关于 require 和 同步 |/O 
require 是 Node 中 少数 几 个 同步 /O 操 作 之 一 。 因 为 经 常用 到 模块 ， 并 且 一 般 都 是 在 文件 
顶端 引入 ， 所 以 把 require 做 成 同步 的 有 助 于 保持 代码 的 整洁 、 有 序 ， 还 能 增强 可 读 性 。 但 在 
程序 中 IO 窖 集 的 地 方 尽量 不 要 用 recuire。 所 有 同步 调用 都 会 阻塞 Node， 直 到 调用 完成 才能 
做 其 他 事情 。 上 比如 你 正在 运行 一 个 HTTP 服 务 器 ， 如 果 在 每 个 进入 的 请 求 上 都 用 了 require， 
就 会 遇 到 性 能 问题 。 所 以 通常 都 只 在 程序 最 初 加 载 时 才 使 用 require 和 其 他 同步 操作 。 


下 面 这 个 是 test-currency .J]S 中 的 代码 , 它 require 了 currency.js 模 块 : 


代码 清单 3-2 ”引入 一 个 模块 
= LEG ed hs > 
var currency require Currency 用 路 径 /表明 模块 跟 程 序 脚本 
放 在 同一 目录 下 
console.log('50 Canadian dollars equals this amount of US dollars:'); 


console.log(currency.canadianToUS(50)); 


使 用 currency 模 块 的 


canadianToUS 函 数 
console.1og('30 US dollars equals this amount of Canadian dollars:'); 


console.log(currency.USToCanadian (30)); 


使 用 currency 模 块 的 


USTocanadian 范 数 


图 灵 社 区 会 员 quqingtao 专 享 尊重 版 权 


3.1 Node 功能 的 组 织 及 重用 39 





引入 一 个 以 . /开头 的 模块 意味 者 ， 如 果 你 准备 创建 的 程序 脚本 test-currencyjs 在 currency_app 
目录 下 , 那 你 的 currency.js 模 块 文件 ,如 图 3-4 所 示 , 应 该 也 放 在 currency app 目 录 下 。 在 引入 时 , .js 

扩展 名 可 以 忽略 。 
2 









currency_app 





test-currency.js 





redquirert', /Currency'):} 


currency.js 


图 3-4 ”如 果 在 require 模 块 时 把 ./ 放 在 前 面 , Node 会 在 被 执行 程序 文件 所 在 的 目录 下 
寻找 这 个 模块 
在 Node 定 位 到 并 计算 好 你 的 模块 之 后 ,redquire 国 数 会 返回 这 个 模块 中 定义 的 exports 对 象 
中 的 内 容 ， 然 后 你 就 可 以 用 这 个 模块 中 的 两 个 函数 做 贷 币 转换 了 。 
如 果 你 想 把 这 个 模块 放 到 子 目 录 中 , 比如 Lib, 只 要 把 require 博 句 改 成 下 面 这 样 束 可 以 了 : 


var currency = require('./lib/currency'); 


组 淡 模 块 中 的 exports 对 和 象 是 在 单独 的 文件 中 组 织 可 重用 代码 的 一 种 简便 方法 。 























9 


一 


.2 ”用 module.exports 微 调 模块 的 创建 


尽管 用 因数 和 变量 组 装 exports 对 象 能 满足 大 多 数 的 模块 创建 需要 , 但 有 时 你 可 能 需要 用 不 
同 的 模型 创建 该 模块 。 

比如 说 ， 前 面 创建 的 那个 货币 转换 厦 模 块 可 以 改 成 只 返回 一 个 currency 构 造 函 数 ， 而 不 是 
包含 两 个 函数 的 对 象 。 一 个 面 回 对 和 象 的 实现 看 起 来 可 能 像 下 面 这 样 : 


Var Currency = require('./currency'); 
var canadianDollar = 0.91: 








var currency = new Currency (canadianDollar}).; 
console.loglcurrency.canadianToUSs {S50))}); 


如 果 只 需要 从 模块 中 得 到 一 个 函数 , 那 从 reauire 中 返回 一 个 函数 的 代码 要 比 返回 一 个 对 象 
的 代码 更 优雅 。 

要 创建 只 返回 一 个 变量 或 函数 的 模块 , 你 可 能 会 以 为 只 要 把 exports 设 定 成 你 想 返 回 的 东西 
网 行 。 但 这 样 是 不 行 的 ,因为 Node 和 党 得 不 能 用 任何 其 他 对 象 、 国 数 或 变量 给 sxports 赋 值 。 下 面 
这 个 代码 清单 中 的 模块 代码 试图 将 一 个 函数 赋值 给 exports。 
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* ~ AN 上 a 
代码 清单 3-3 ”这 个 模块 不 能 
Var Currency = function(canadianDollar}) f{ 
this.canadianDollar = canadianDollar: 


} 


Currency.prototype.roundTwoDecimals = function(amount} { 
return Math.round(amount * 100) / 100; 
} 


Currency.prototype.canadianToUs = function(canadian) { 
return this.roundTwoDecimals (canadian * this.canadianDollar}): 


} 


Currency.prototype.USToCanadian = function(us) { 

return this.roundTwoDecimals (us / this.canadianDollar).; 
错误 ，Node 不 允许 
重 写 exports 


} 

exports = Currency; 

为 了 让 剖面 那个 模块 的 代码 能 用 , 需要 把 exports 换 成 module .exports。 用 module.exports 
可 以 对 外 提供 单个 变量 、 郴 数 或 者 对 象 。 如 果 你 创建 了 一 个 既 有 exports 又 有 moqule.exports 
的 模块 ， 那 它 会 返回 module .exports， 而 exports 会 被 忽略 。 








导出 的 究竟 是 什么 
最 终 在 程序 里 导出 的 是 module.exports。exports 只 是 对 module.exports 的 一 个 全 
局 引用 ， 最 初 被 定义 为 一 个 可 以 添加 属性 的 空 对 象 。 所 以 exports .myFunc 只 是 


module.exports.myFunc 的 简写 。 


所 以 ， 如 果 把 exports 设 定 为 别 的 ,就 打破 了 module .exports 和 exports 之 间 的 
引用 关系 。 可 是 因为 真正 导出 的 是 module. ee ， 那 样 exports 就 不 能 用 了 ， 因 为 
它 不 再 指向 module.exports 了 。 如 果 你 想 维 持 那 个 链接 ， 可 以 像 下 面 这 样 让 
module .exports 青 次 引用 exports: 


module.exports = exports = Currency:; 
根据 需要 使 用 export s 或 module ; exports 可 以 将 功能 组 织 成 模块 ? 规避 掉 程 序 脚 本 一 直 增 
长 产生 的 浆 端 。 


3.1.3 ”用 node_modules 重 用 模块 


要 求 模块 在 文件 系统 中 使 用 相对 路 径 存 放 , 对 于 组 织 程序 特定 的 代码 很 有 帮助 , 但 对 于 想 要 
在 程序 间 共 人 至 或 跟 其 他 人 共 至 代 码 邢 用 处 不 大 。 Node 中 有 一 个 独特 的 模块 引入 机 制 , 可 以 不 必 知 
道 模 块 在 文件 系统 中 的 具体 位 置 。 这 个 机 制 就 是 使 用 node_modules 目 录 。 

前 面 那 个 模块 的 例子 中 引入 的 是 . /Currencyo 如 果 省 略 . /， 人 和信 只 与 curtency， Node 会 于 照 
儿 个 规则 搜寻 这 个 模块 ， 如 图 3-5 所 示 。 
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开始 在 程序 文件 
同一 目录 下 查找 








征 核心 


返回 模块 





No 







Yes 








模块 在 当前 目 东 下 的 
node_ modules 目 孙 下 吗 









父 目录 仓 在 吗 


No 








模块 在 由 环境 变量 
NODE_PATH 
定 的 目录 下 吗 











图 3-5 ”查找 模块 的 步 又 


用 环境 变量 NODE_PATH 可 以 改变 Node 模 块 的 默认 路 径 。 如 果 用 了 它 , NODE_PATH 在 Windows 
中 应 该 设置 为 用 分 号 分 隔 的 目录 列表 ， 在 其 他 操作 系统 中 用 冒号 分 隔 。 





3.1.4 注意 事项 





尽管 Node 模 块 系统 的 本 质 简 单 直接 ， 但 还 是 有 两 点 需要 注意 一 下 。 

第 一 ， 如 果 模 块 是 目录 , 在 模块 目录 中 定义 模块 的 文件 必须 被 命名 为 index.js, 除非 你 在 这 个 
目录 下 一 个 叫 package.json 的 文件 里 特别 指明 。 要 指定 一 个 取代 index.js 的 文件 ，package.json 文 件 
里 必须 有 一 个 用 JavaScript 对 象 表 示 法 (JSON ) 数据 定义 的 对 象 ， 其 中 有 一 个 名 为 main 的 健 ， 指 
明 模块 目录 内 主 文件 的 路 径 。 图 3-6 中 的 流程 图 对 这 些 规则 做 了 汇总 。 
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找到 模块 目 永 


有 package.json 
文件 吗 ? 


















No 





main 元 素 中 
站 定 的 文件 
存在 吗 ? 


package.json 
文件 中 有 main 
元 素 吗 ? 










No No Yes 


No 用 main 元 素 中 
抛 出 异 向 指定 的 文件 
定义 模块 


有 index.js 
文件 吗 ? 


Yes 
用 index.]s 
文件 定义 模块 


图 3-6 ” 当 模 块 目 录 下 有 package.json 文 件 时 ， 你 可 以 用 index.js 之 外 的 其 他 文件 定义 目 
己 的 模块 


这 里 有 个 package.json 文件 的 例子 ， 它 指定 currency.js 为 主 文件 : 
{ 


"malin": "./Ccurrency.js" 


} 

还 有 一 点 需要 注意 的 是 , Node 能 把 模块 作为 对 象 缓存 起 来 。 如 来 程序 中 的 两 个 文件 引入 了 相 
同 的 模块 , 第 一 个 文件 会 把 模块 返回 的 数据 存 到 程序 的 内 存 中 , 这 样 第 二 个 文件 就 不 用 再 去 访问 
和 计算 模块 的 源 文 件 了 了。 实际 上 第 二 个 引入 有 机 会 修改 缓存 的 数据 。 这 种 “猴子 补丁 (monkey 
patching ) 证 一 个 模块 可 以 改变 另 一 个 模块 的 行为 ， 开 发 人 员 可 以 不 用 创建 它 的 新 版 本 。 

兄 悉 Node 醒 块 系统 最 好 的 办 法 是 目 己 动手 试 一 坛 , 亲 目 验证 一 下 本 市 所 措 述 的 Node 的 行为 。 

你 对 醒 匡 的 工作 机 制 有 了 基本 的 认识 ， 接 下 来 我 们 开始 学 习 寞 步 编程 技术 吧 。 


3.2 “异步 编程 技术 


如 打 你 做 过 Web 前 闪 编 程 ， 并 且 遇 到 过 界面 事件 〈 比如 鼠标 点 击 ) 触发 的 逻辑 ， 那 你 就 做 过 
异步 编程 。 服 务 关 异步 编程 也 一 样 : 事件 发 生 会 触 皮 啊 应 逻辑 。 在 Node 的 世界 里 流行 两 种 啊 应 逻 
辑 管理 方式 : 回调 和 事件 监听 。 

回调 通 篆 用 来 定义 一 次 性 啊 应 的 逻辑 。 比 如 对 于 数据 库 查 询 , 可 以 指定 一 个 回调 函数 来 确定 
如 何 处 理 碍 询 结果 。 这 个 回调 函数 可 能 会 显示 数据 库 查 询 绪 末 , 根据 这 些 结果 做 些 计 算 , 或 者 以 
查询 结果 为 参数 执行 力 一 个 回调 函数 。 
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事件 监听 器 ， 本 质 上 也 是 一 个 回调 ， 不 同 的 是 ， 它 跟 一 个 概念 实体 〈 事 件 ) 相关 联 。 例 如 ， 
当 有 人 在 浏览 硕 中 点 击 鼠 标 时 ， 鼠 标点 击 是 一 个 需要 处 理 的 事件 。 在 Node 中 ， 当 有 HTTP 请 求 过 
来 时 ，HTTP 服 务 融 会 发 出 一 个 请 求 事 件 。 你 可 以 监听 那个 请 求 事 件 ， 并 添加 一 些 响应 逻辑 。 在 
下 面 这 个 例子 中 ， 每 当 有 请 求 事件 发 出 时 ， 服 务 融 就 会 调用 nandleRecuest 函 数 : 

Server.on('regquest', handleRequest) 

一 个 Node HTTP 服务 胡 实 例 就 是 一 个 事件 发 射 锅 ,一 个 可 以 继承 、 能 够 涂 加 事件 发 射 及 处 理 
能 力 的 类 ( EventEmitter 局 Node 的 很 多 核心 功能 都 继承 自 EventEmitter, 你 也 能 j 建 日 局, 
的 事件 发 射 欠 。 

Node 有 两 种 和 常用 的 啊 应 逻辑 组 织 方式 , 我 们 已 经 用 其 中 一 种 构建 了 啊 应 逻辑 , 现在 该 了 解 一 
下 它 是 如 何 实现 的 了 ， 所 以 接 下 来 要 学 习 如 下 内 容 : 

口 如 何 用 回调 处 理 一 次 性 事件 ; 

口 如 何 用 事件 监听 融 啊 应 重复 性 事件 ; 

口 异步 编程 的 几 个 难点 。 

先 来 看 这 个 最 第 用 的 异步 代码 编写 方式 : 使 用 回调 。 


3.2.1 用 回调 处 理 一 次 性 事件 


回调 是 一 个 孔 数 ， 它 被 当做 参数 传 给 异步 函数 ， 它 摘 述 了 异步 操作 完成 之 后 要 做 什么 。 回 调 
在 Node 开 发 中 用 得 很 频 索 ， 比 事件 发 射 背 用 得 多 ， 并 且 用 起 来 也 很 简单 。 

为 了 在 程序 中 演示 回调 的 用 法 ， 我 们 来 做 一 个 简单 的 HITP 服 务 硕 ， 让 它 实 现 如 下 功能 : 

口 异步 获取 存放 在 JSON 文 件 中 的 文章 的 标题 ; 

口 异步 获取 简单 的 HTML 模 板 ; 

口 把 那些 标题 组 妆 到 HTML 页 面 里 ; 

口 把 HTML 页 面 发 送 给 用 户 。 

最 终结 果 如 图 3-7 所 示 。 












































|- Mozia Frat 


hispcir ft L370 Lj 中 


人 EECTTT 


Latest Posts 


a Rarakhorarn a a bop Cowrnry... wh pos 06 tese? 
= Th Weatdr 1s akie Tlet CTaadey 
s My melglibar Sout Gd bals a night 








图 3-7 来 自 Web 服 务 器 的 HTML 响 应 ， 从 JSON 文 件 中 获取 标题 并 返回 一 个 Web 页 面 
JSON 文 件 ( titles.json ) 会 被 格式 化 成 一 个 包含 文章 标题 的 字符 串 数 组 ， 内 容 如 下 所 示 。 
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* :二 = 全 = | 
代码 清单 3-4 一 个 包含 文章 标题 的 列表 
[ 
"Kazakhstan is a huge country... what goes on there?", 
"This weather is making me craaazZy'", 
"My neighbor sort of howls at night" 
] 


HTML 模 板 文件 ( template.html )， 如 下 所 示 ， 结 构 很 兴 单 ， 可 以 搬入 博客 文章 的 标题 。 


代码 清单 3-5 ”用 来 演 染 博客 标题 的 HTML 模 板 
<ldoctype html> 
<html> 
<head></head> 
<body> 
<hl>Latest Posgtes</hl> | % 会 被 替换 为 标题 
<ul><l1i>%</1i></ul> 
</body> 
</html> 


获取 JSON 文 件 中 的 标题 并 演 染 Web 页 面 的 代码 如 下 所 示 ( blog recent.js )， 其 中 的 回调 函数 
以 黑体 显示 。 
代码 清单 3-6 ”在 简单 的 程序 中 使 用 回调 的 例子 
var http = require('http'); 
| 创建 HTTP 服 务 器 并 用 回调 





var fs = regquire('fs'); zy bi 
定义 响应 逻辑 
http.createServer (function(req, res) { 
if (regq.url == '/') { 
fs.readFile('./titles.json', function(err, data) { 


if (err) { ee 扇 取 JSON 文 件 并 用 
donsole. error (srr):; 2 输出 错误 日 回调 定义 如 何 处 理 
res.end('Server Error').， 志 ， 并 给 客 己 端 返回 其 中 的 内 容 
“Server Error” 
else { 
var titles = JSON.parse(data.toString()); 
从 JSON 文 本 
中 解析 数据 fs.readFile('./template.html', function(err, data) { 
if (err) { 
oe 痰 取 HTML 模 板 ， 并 在 加 载 
, : ' 完成 后 使 用 回调 
else { 
Var tmpl = data.toString().; 
Var html = tmpl.replace('%', titles.join('</1i><11i>')); 
res.writeHead(200, {'Content-Type': 'text/html'}).; 
res.end (html).; 组 装 HTML 页 面 以 
} 将 HTML 页 面 发 送 a 
Mr VIAN 示 量 
| 给 用 户 显示 博客 标题 


}).listen(8000, "127.0.0.1"); 
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这 个 例子 租 入 了 三 层 回 调 . 
http.createServer (function(req, res) { 


fs.readFile('./titles.json', function (err, data) { 
ts.readFile('./template.html', function (err, data) { 


三 层 还 算 可 以 , 但 回调 层 数 越 多 ,代码 看 起 来 越 乱 ， 重 构 和 测试 起 来 也 越 困 难 ， 所 以 最 好 限 
制 一 下 回调 的 般 套 层级 。 如 果 把 每 一 层 回 调和 多 套 的 处 理 做 成 命名 函数 , 虽然 表示 相同 逻辑 所 用 的 
代码 变 多 了 ， 但 维护 、 测 试 和 重 构 起 来 会 更 容易 。 下 面 代 码 清单 中 的 代码 功能 跟 代 码 清单 3-6 中 
的 一 样 。 


代码 清单 3-7 创建 中 间 函 数 以 减少 舱 套 的 例子 




















var http = require('http'); 
Var fs = require('fs'); 客户 端 请 求 一 开始 会 进 到 
var server = http.createServer (function (regq, res) { 这 里 
getTitles (res),; 
Tisten(8000, "127.0.0.1"Yy; | 控制 权 转 交 给 了 getTitles 
function getTitles(res) { 
fs.readFile('./titles.json', function (err, data) { 
if (err) { 获取 标题 ， 并 将 控制 权 转 交 
hadError (err, res),; 给 getTemplate 
} 
else { 
getTemplate(JSON.parse(data.toString()), res); 
} 
}) 
} getTemplate 读 取 模 板 文 件 ， 并 
， 将 控制 权 转 交 给 formatHtml 
function getTemplate(titles, res) { 


fs.readFile('./template.html', function (err, data) { 
if {err) { 
hadErrorl(lerr, res); 


} 


else 1 
formatHtml (titles, data.toString(), res); 
} 
. formatHtml 得 到 标题 和 模板 ， 演 
} 染 一 个 响应 给 客户 端 
function formatHtml (titles, tmpl, res) { 
Var html = tmpl.replace('%', titles.join('</1i><1i>')); 
res.writeHead(200, {'Content-Type': 'text/html'}).; 
res.end (html).; 
} Si NA 口 * 口 
如 果 这 个 过 程 中 出 现 了 错误 , hadError 
function hadError(err, res) 1 会 将 错误 输出 到 控制 台 , 并 给 客户 端 返 
console.error (err); 回 “Server Error” 


res.end('Server Error ' ) ; 


} 
你 还 可 以 用 Node 开 发 中 的 另 一 种 惯用 法 减少 由 ielse 引 起 的 能 套 : 尽早 从 因数 中 返回 。 下 面 
的 代码 清单 功能 跟前 面 一 样 , 但 通过 尽早 返回 的 做 法 避免 了 进一步 的 通 套 。 它 还 明确 表示 出 了 困 
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数 不 应 该 继续 执行 的 意思 。 
代码 清单 3-8 通过 尽早 返回 减少 通 父 的 例子 


var http = require('http'); 





Var fs = regquire('fs'); 
var server = http.createServer (function (regq, res) 
getTitles (res); 在 这 里 不 再 创建 一 个 else 


}).listen(8000, "127.0.0.1"); 分 支 ， ee 








function getTitles (res) { 为 如 果 出 错 的 话 ， 也 没 必 要 
fs.readFile('./titles.json', function (err, data) { 继续 执行 这 个 函数 了 
If (err) return hadError (err, res) 
getTemplate (JSON.parse (data.toString()), res) 
1) 
} 
function getTemplate (titles, res) { 
fs.readFile('./template.html', function (err, data) { 
if (err) return hadError (err, res) 
formatHtml (titles, data.toSstring(), res) 
}) 
} 
function formatHtml (titles, tmpl, res}) { 
var html = tmpl.replace('%®%', titles.join({'</li><11i>')); 
res.writeHead(200, {'Content-Type': 'text/html'}):; 
res.end{html}).; 


} 


function hadError(err, res) 1 
console.error (err) 
res.end!('Server Error') 


} 


你 已 经 学 过 如 何 用 回调 为 谈 取 文件 和 Web 服 务 表 请 求 这 样 的 一 次 性 任务 定义 啊 应 了 , 接 下 来 
0 只 事件 。 


Node 的 异步 回调 惯例 
Node 中 的 大 多 数 内 置 模块 在 使 用 回调 时 都 会 带 两 个 参数 : 第 一 个 是 用 来 放 可 能 会 发 生 的 
错误 的 ， 第 二 个 是 放 台 本 错误 和 参数 经 常 被 缩写 为 er 或 err。 


文 个 常用 的 函数 签名 的 典型 示例 : 
var fs = require('fs'); 
fs.readFile('./titles.json', function(er, data) { 


if (er) throw er; 
// do something with data if no error has occurred 


i 


3.2.2 ”用 事件 发 射 器 处 理 重复 性 事件 
事件 发 射 器 会 触发 事件 ， 并 且 在 那些 事件 被 触发 时 能 处 理 它们 。 一 些 重要 的 Node API 组 件 ， 
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比如 HTTP 服 务 器 、TCP 服 务 硕 和 流 ， 都 被 做 成 了 事件 发 射 锋 。 你 也 可 以 创建 和 目 己 的 事件 发 射 硕 。 

我 们 之 前 说 过 ， 事 件 是 通过 监听 需 进 行 处 理 的 。 监 听 需 是 跟 事 件 相 关联 的 ,市 有 一 个 事件 出 
现时 就 会 被 触发 的 回调 函数 。 比 如 Node 中 的 TCP socket， 它 有 一 个 data 事 件 ， 每 当 socket 中 有 新 
数据 时 就 会 触发 : 

socket.on('data', handleData); 

我 们 看 一 下 用 data 事 件 创建 的 echo 服 务 妖 。 

1. 事件 发 射 器 示例 

echo 服 务 春 就 是 个 处 理 重复 性 事件 的 人 简单 例子 ， 当 你 给 它 发 送 数 据 时 ， 它 会 把 那个 数据 发 回 
来 ， 如 图 3-8 所 示 。 











D 


AMA 2. Shell 


Last login: Sun Nov 27 15:08:28 on ttys000 
Mike-Cantelons-MacBook|~$ telnet 127.0.0.1 8888 
Trying 127.0.0.1... 

Connected to localhost. 

Escape character is '^]'". 


Line one 
Line one 
Line two 
Line two 





图 3-8 ” 回 送 发 送 给 它 的 数据 的 echo 服 务 融 


下 面 的 代码 清单 实现 了 一 个 echo 服 务 促 。 当 有 客户 端 连 接 上 来 时 ， 它 就 会 创建 一 个 socket。 
socket 是 个 事件 发 射 句 ， 可 以 用 on 方法 添加 监听 需 啊 应 aata 事 件 。 只 要 socket 上 有 新 数据 过 来 ， 
就 会 发 出 这 些 qata 事 件 。 


代码 清单 3-9 ”用 on 方法 响应 事件 








Var net = requirel('net').; 
当 读 取 到 新 数据 时 处 理 的 
Var server = net.createServer(function(socket) { 由 
socket.on('data', function(data) { 
socket .write (data).,; 
Fs | 数据 被 写 回 到 客户 端 


}); 
server.listen(8888); 


用 下 面 这 条 命令 可 以 运行 echo 服 务 需 : 





node echo_ server.is 

echo 服 务 融和 运行 起 来 之 后 ， 你 可 以 用 下 面 这 条 命令 连 上 去 : 

telnet 127.0.0.1 8888 

你 每 次 通过 连 上 去 的 telnet 会 话 把 数据 发 送 给 服务 硕 ， 数 据 就 会 传 回 到 telnet 会 话 中 。 
Windows 上 的 Telnet 如 果 你 用 的 是 微软 的 Windows 操 作 系统 ， 那 上 面 可 能 还 没 装 

telnet， 你 得 自己 装 。TechNet 上 有 各 版 本 Windows 下 的 安装 指南 : http://mng.bz/egzr。 














图 灵 社 区 会 员 quqingtao 专 享 尊重 版 权 


48 第 3 章 ”Node 编程 基础 


2. 响应 只 应 该 发 生 一 次 的 事件 

监听 需 可 以 被 定义 成 持续 不 断 地 啊 应 事件 ， 如 上 例 所 示 ,， 也 能 被 定义 成 只 响应 一 次 。 下 面 的 
代码 用 了 了 once 方法， 对 前 面 那个 echo 服 务 善 做 了 修改 ， 让 它 只 回应 第 一 次 发 送 过 来 的 数据 。 
代码 清单 3-10 ”用 once 方 法 啊 应 单 次 事件 


var net = requirel('net').; 





Var server = net.createServer (function(socket) { 


data 只 被 处 理 一 次 
socket.once ('data', function(data) { 事件 只 被 / 


socket .write (data).: 
了 
7 


server.listen(8888).;: 

3. 创建 事件 发 射 器 : 一 个 PUB/SUB 的 例子 

前 面 的 例子 用 了 一 个 带 事件 发 射 锅 的 Node 内 置 API。 然而 你 可 以 用 Node 内 置 的 事件 模块 创建 
目 己 的 事件 发 射 从 。 


下 面 的 代 人 码 定义 了 一 个 channe1 事 件 发 射 着 , 这 有 一 个 监听 需 , 可 以 癌 加 入 频道 的 人 做 出 啊 
应 。 注 意 这 里 用 on (或 者 用 比较 长 的 addListener ) 方法 给 事件 发 射 器 添加 了 监听 需 : 





var EventEmitter = require('events') .EventEmitter:; 
var channel = new EventEmitter!()}).: 
channel .on('jJoin’', function() { 


console.log("Welcome!").; 
}); 


然而 这 个 join 回 调 永远 都 不 会 被 调用 ， 因 为 你 还 没 发 射 任何 事件 。 所 以 还 要 在 上 面 的 代码 
中 加 上 一 行 ， 用 emit 阴 数 发 射 这 个 事件 : 


channel .emit('jJoin'); 








事件 名 称 


事件 只 是 个 键 ， 可 以 是 任何 字符 串 : data、join 或 菜 些 长 的 让 人 发 疯 的 事件 名 都 行 。 只 
有 一 个 事件 是 特殊 的 ， 那 就 是 error， 我 们 马上 就 会 看 到 它 。 





你 在 第 2 章 用 具有 发 布 /预订 功能 的 SocketIO 模 块 构建 了 一 个 聊天 程序 。 接 下 来 我 们 看 看 应 该 
如 何 实现 目 己 的 发 布 /预订 逻辑 。 

代码 清单 3-11 是 一 个 徐 单 的 聊天 服务 硕 。 聊 天 服务 从 的 频 赴 被 做 成 了 事件 发 射 希 ， 能 对 客户 端 
发 出 的 join 事件 做 出 啊 应 。 当 有 客户 闯 加 入 聊天 频道 时 , join 监听 天 逻辑 会 将 一 个 针对 该 客户 闪 的 
监听 器 附加 到 频道 上 , 用 来 处 理会 将 所 有 广播 消息 写 人 该 客户 端 socket 的 broadcast 事 件 。 事件 类 型 
的 名 称 ， 比 如 join 和 broaqcast， 完 全 是 随意 取 的 。 你 也 可 以 按 目 己 的 喜好 给 它们 换个 名 字 。 
代码 清单 3-11 用 事件 发 射 名 实现 的 简单 的 发 布 /预订 系统 


var events = require('events').; 
var net = require('net'),; 
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Var channel = new events.EventEmitter(); 
channel.clients = {}; 添加 join 事件 的 监听 器 ， 保 
channel.subscriptions = {}; 存 用 户 的 client 对 象 ， 以 便 
channel.on('join', function(id, client) { 程序 可 以 将 数据 发 送 给 用 户 
this.clients[id] = client; 
this.subscriptions[id] = function(senderId, message) { 
If (id != senderId) { . 
this.clients[id] .write (message).; | 忽略 发 出 这 一 广播 数据 的 用 户 
} 
} 
this.on('broadcast', this.subscriptions[id]); 
ee a 
的 broadcast 事 件 监 听 器 
Var server = net.createServer(function (client) f{ 
Var id = client.remoteAddress + ':' + Client.remotePort,; 
client.on('connect', function() { 
人 Join', id, client).; 当 有 用 户 连 到 服务 器 上 来 时 发 出 一 个 
client.on('data', function(data) { join 事件 ， 指 明 用 尸 ID 和 client 对 象 
data = qdqata.toStrlIna() :; 
channel .emit('broadcast', id, data); 当 有 用 户 发 送 数据 时 ， 发 出 一 个 
上 频道 broadcast 事 件 ， 指 明 用 户 
3 ID 和 消息 


server.listen(8888); 


把 聊天 服务 表 跑 起 来 后 ， 在 命令 行 中 输入 下 面 的 命令 进入 聊天 程序 : 








telnet 127.0.0.1 8888 

如 果 你 打开 几 个 命令 行 窗口 , 在 其 中 任何 一 个 窗口 中 输入 的 内 容 都 将 会 被 发 送 到 其 他 所 有 窗 
加 时 5 

这 个 聊天 服务 硕 还 有 个 问题 ,在 用 户 关闭 连接 离开 聊天 室 后 ， 原 来 那个 监听 融 还 在 ， 仍 会 答 
试问 已 经 断 开 的 连接 写 数 据 。 这 样 目 然 就 会 出 错 。 为 了 解决 这 个 问题 ,你 还 要 按照 下 面 的 代码 清 
单 把 监听 需 沃 加 到 频道 事件 发 射 锅 上 ， 并 且 回 服务 硕 的 close 事 件 监听 希 中 深 加 发 射频 道 的 
eave 事 件 的 处 理 逻 辑 o 1 eave 事 件 本 质 上 就 是 要 移 除 原来 给 客户 疹 添加 的 bzoadqcast 监 听 入 。 


代码 清单 3-12 ”创建 一 个 在 用 户 断 开 连 接 时 能 打扫 战场 的 监听 天 
| 创建 leave 事 件 的 监听 器 











channel .on('leave', function(id) { 
channel .removeListener ( 
'broadcast', this.subscriptions[id]); 


channel.emit('broadcast', id, id + " has Left the chat.\n").; 


} 3 
移 除 指定 客户 端的 broadcast 


var Server = net.createServer (function (client) 1 监听 器 
client on( close'y FunctLon() | 
channel .emit('leave', id); 在 用 户 断 开 连 接 时 发 出 leave 
, 事件 


}); 


server.listen(8888).; 


图 灵 社 区 会 员 quqingtao 专 享 尊重 版 权 





50 第 3 章 ”Node 编程 基础 


如 果 出 于 某 种 原 因 你 想 人 和 停止 提供 聊天 服务 ， 但 又 不 想 关 抒 服 务 需 ， 可 以 用 removeA11L- 
isteners 事 件 发 射 表 方法 去 抒 给 定 类 型 的 全 部 监听 硕 。 下 面 是 在 我 们 的 聊天 服务 硕 上 使 用 这 一 





方法 的 示例 : 
channel .on('shutdown', functiont{t) { 
channel .emit('broadcast', '', "Chat has shut down.\n"): 


channel .removeAllListeners{'broadcast')}):; 


i 
然后 你 可 以 添加 一 个 停止 服务 的 聊天 命令 。 为 此 需要 将 aata 事 件 的 监听 顺 改 成 下 面 这 样 : 


client.on('data', function(data) { 
data = data.tostringt(); 
if (data == "shutdown\r\n") { 
channel .emit('shutdown').; 
} 
channel .emit('broadcast', id, data):; 


J 
现在 只 要 有 人 输入 shutdown 命 令 ， 所 有 参与 聊天 的 人 都 会 被 跑 出 去 。 


着 误 处 理 

在 错误 处 理 上 有 个 常规 做 法 ,你 可 以 创建 发 出 error 类 型 事件 的 事件 发 射 器 ， 而 不 是 直接 
抛 出 错误 ,这 样 就 可 以 为 这 一 事件 类 型 设置 一 个 或 多 个 监听 器 ,从 而 定义 定制 的 事件 响应 逻辑 。 

下 面 的 代码 显示 的 是 一 个 错误 监听 器 如 何 将 被 发 出 的 错误 输出 到 控制 台中 : 

Var events = require('events'); 

Var myEmitter = new events.EventEmitter(); 

myEmitter.on('error', function(err) { 

Console.log('ERROR: ' + err.message); 

> 

myEmitter.emit('error', new Error('Something is wrong.')); 

如 果 这 个 error 事 件 类 型 被 发 出 时 没有 该 事件 类 型 的 监听 器 , 事件 发 射 器 会 输出 一 个 堆栈 
跟踪 ( 到 错误 发 生 时 所 执行 过 的 程序 指令 列表 ) 并 停止 执行 。 堆 栈 跟 踪 会 用 emit 调 用 的 第 二 
个 参数 指明 错误 类 型 。 这 是 只 有 错误 类 型 事件 才能 享受 的 特殊 待遇 , 在 发 出 没有 监听 器 的 其 他 
事件 类 型 时 ， 什 么 也 不 会 发 生 。 

如 果 发 出 的 ertror 类 型 事件 没有 作为 第 二 个 参数 的 error 对 象 ， 堆 栈 跟踪 会 指出 一 个 “未 
捕获 、 未 指明 的 "错误 ?事件 ”错误 ， 并 且 程 序 会 停止 执行 。 你 可 以 用 一 个 已 经 被 废除 的 方法 处 
理 这 个 错误 ， 用 下 面 的 代码 定义 一 个 全 局 处 理 器 实现 响应 还 辑 : 

process.on('uncaughtException', function(err)t 

Console.error (err.stack); 
process.exit (1).; 

了 六 5 

除了 这 人 个， 还 有 像 domain ( http://nodejs.org/api/domain.html ) 这 样 正 在 开发 的 方案 ， 但 它 
们 是 实验 性 质 的 。 
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如 条 你 想 让 连接 上 来 的 用 户 看 到 当前 有 几 个 已 连接 的 聊天 用 户 ， 可 以 用 下 面 这 个 监听 天 方 
法 ， 它 能 根据 给 定 的 事件 类 型 返回 一 个 监听 带 数 组 : 


channel.on('join', function(id, client}) ff 
var welcome = "Welcome! ‘\n'" 
+ 'Guests online: ' + this.listeners('broadcast') .length.:; 


client.write(welcome + "An") ， 


为 了 增加 能 够 附加 到 事件 发 射 器 上 的 监听 器 数量 ,不 让 Node 在 监听 器 数量 超过 10 个 时 向 你 发 
出 警告 ， 可 以 用 setMaxristeners 方 法 。 以 频道 事件 发 射 器 为 例 ， 可 以 用 下 面 的 代码 增加 监听 
器 的 数量 : 

channel .setMaxLlISstemers1(501) ，; 

4. 扩展 事件 监听 器 : 文件 监视 器 

如 果 你 想 在 事件 发 射 器 的 基础 上 构建 程序 ， 可 以 创建 一 个 新 的 JavaScript 类 继承 事件 发 射 器 。 
比如 创建 一 个 watcher 类 来 处 理 放 在 某 个 目录 下 的 文件 。 然后 可 以 用 这 个 类 创建 一 个 工具 , 该 工 
具 可 以 监视 目录 ( 将 放 到 里 面 的 文件 名 都 改 成 小 写 )， 并 将 文件 复制 到 一 个 单独 目录 中 。 

扩展 事件 发 射 器 需要 三 步 

(1) 创建 类 的 构造 器; 

(2) 继承 事件 发 射 器 的 行为 ; 














(3) 扩展 这 些 行为 。 
下 面 的 代码 是 watcher 类 的 构造 器 。 它 的 两 个 参数 分 别 是 要 监控 的 目录 和 放置 修改 过 的 文件 
的 目录 : 
function Watcher (watchDir, processedDir) { 
this,.watchDir = WatchDir; 


this.processedDir = processedDir.; 


} 
接 下 来 要 添加 继承 事件 发 射 帮 行 为 的 代码 : 
var events = require ('events') 

: Util = regquire('util'}). 


util.inherits (Watcher, events.EventEmitter); 

注意 inherits 国 数 的 用 法 ， 它 是 Node 内 置 的 util 模 块 里 的 。 用 inherits 困 数 继承 另 一 个 
对 象 里 的 行为 看 起 来 很 何洁 。 

上 面 那 段 代 码 中 的 inherits 语 名 等 同 于 下 面 的 JavaScript: 

Watchetr. Prototype = new events.EventEmitter(); 

设置 好 watcher 对 象 后 , 还 需要 加 两 个 新 方法 扩展 继承 目 EventEmitter 的 方法 , 代码 如 
下 态 不 。 


代码 清单 3-13 扩展 事件 发 射 从 的 功能 


var fs = regquiret{'fs') 
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; WatchDir = './watch,' 
, processedDir = './done'; 扩展 BventBmitter， 
添加 处 理 文 件 的 方法 
Watcher.prototype.watch = function() { 
Var watcher = this; 
保存 对 Watcher 


fs.readdir (this.watchDir, function(err, files) { 


对 象 的 引用 ， 以 
便 在 回调 范 数 


if (err) throw erL; 
for(var index in files) { 


watcher.emit('process', files[index]); readdir 中 使 用 
处 理 watch } 
目录 中 的 所 1) 
有 文件 } 
Watcher.prototype.start = function() { 扩展 EventEmitter, 添加 开 
Var Won = this; 台 监控 的 方法 
fs.watchFile(watchDir, function() { 


watcher.watch().,; 
}); 
} 


watch 方 法 循环 让 历 日 录 ， 处 理 其 中 的 所 有 文件 。start 方 法 启动 对 日 录 的 览 控 。 监 控 用 到 
了 Node 的 fs .watchFile 消 数 ， 所 以 当 人 被 监控 的 日 录 中 有 事情 发 生 时 ，watch 方 法 会 被 触发 , 循 
环 遍历 受 监 控 的 目录 ， 并 针对 其 中 的 每 一 个 文件 发 出 process 事 件 。 

定义 好 了 watcher 类 ， 可 以 用 下 面 的 代码 创建 一 个 watcher 对 有 象 : 

var Watcher = new Watcher (watchDir, processedDir); 

有 了 新 创建 的 Watcher 对 象 ， 你 可 以 用 继承 旧事 件 发 射 各 类 的 on 方法 设 定 文件 的 处 理 逻 辑 ， 
如 下 所 示 : 


watcher.on( 'process', function process (file) { 
this.watchDir + '/' + file; 
this.processedDir + '/' + file.toLowerCase!(),; 

















var watchFile 


Var processedFile 


fs.rename (watchFile, processedrFile, function{(err) 1 
if {err) throw err:; 

了 

$3 


现在 所 有 必要 人 逻辑 都 已 经 就 位 了 ， 可 以 用 下 面 这 行 代码 局 动 对 目录 的 监控 : 

watcher.start!{().; 

把 Watcher 代 码 放 到 脚本 中 ， 创 建 watch 和 done 目 录 ， 你 应 该 能 用 Node 运 行 这 个 脚本 ， 把 
文件 丢 到 watch 目 录 中 ,然后 看 着 文件 出 现在 done 目 录 中 ,文件 名 被 改 成 小 写 。 这 就 是 用 事件 发 
射 禹 创建 新 类 的 例子 。 

通过 学 习 如 何 使 用 回调 定义 一 次 性 异步 逮 辑 ,以 及 如 何 用 事件 发 射 帝 重复 派发 异步 逻辑 , 你 
离 擎 控 Node 程 序 的 行为 又 近 了 一 步 。 然 而 你 可 能 还 想 在 单个 回调 或 事件 发 射 硕 的 监听 需 中 添加 新 
的 弄 步 任务 。 如 打 这 些 任 务 的 执行 顺序 很 重要 ， 你 就 会 面 对 新 的 难题 : 如 何 准确 控制 一 系列 异步 
任务 里 的 每 个 任务 。 

在 我 们 学 习 如 何 控制 任务 的 执行 之 前 〈3.3 节 )， 先 看 一 看 在 你 写 寞 步 代码 时 可 能 会 磁 到 哪些 
难题 。 
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3.2.3 ”异步 开发 的 难题 


在 创建 异步 程序 时 ,你 必须 密切 关注 程序 的 执行 流程 ,并 瞪 大 眼睛 采 着 程序 的 状态 : 事件 轮 
询 的 条 件 、 程 序 变 量 ， 以 及 其 他 随 着 程序 逻辑 执行 而 发 生变 化 的 资源 。 

比如 说 ，Node 的 事件 轮 询 会 跟踪 还 没有 完成 的 异步 迎 辑 。 只 要 有 末 完 成 的 异步 迎 辑 ，Node 
进程 就 不 会 退出 。 一 个 持续 运行 的 Node 进 程 对 Web 服 务 器 之 类 的 应 用 来 说 很 有 必要 , 但 对 于 命令 
行 工 具 这 种 经 过 一 段 时 间 后 就 应 该 结束 的 应 用 却 意义 不 大 。 事件 轮 询 会 跟踪 所 有 数据 库 连 接 ， 直 
到 它们 关闭 ， 以 防止 Node 退 出 。 

如 果 你 不 小 心 ,程序 的 变量 也 可 能 会 出 现 意 想不到 的 变化 。 代 码 清单 3-14 是 一 段 可 能 因为 执 
行 顺序 而 导致 混乱 的 异步 代码 。 如 果 例 子 中 的 代码 能 够 同步 执行 ， 你 可 以 肯定 输出 应 该 是 “The 
color is blue”。 可 这 个 例子 是 异步 的 ， 在 console.1og 执 行 之 前 color 的 值 还 在 变化 ， 所 以 输出 


是 “The color is green”。 


代码 清单 3-14 ”作用 域 是 如 何 导 致 bug 出 现 的 
function asyncFunction(callback) { 
setTimeout (callback, 200); 
} 

















Var color = 'blue',; 

asyncFunction(function() { 这 个 最 后 执行 “200ms 之 后 ) 
console.log('The color is ' + Color):; 

站 

Color = 'green'; 


用 JavaScript 闭 包 可 以 “冻结 ”color 的 值 。 在 代码 清单 3-15 中 ， 对 asyncFunction 的 调用 
被 封装 到 了 一 个 以 coloz 为 参数 的 匿名 因 数 里 。 这 样 你 就 可 以 马上 执行 这 个 匿名 函数 ,把 当前 的 
color 的 值 传 给 它 。 而 color 变 成 了 匿名 也 数 的 参数 ， 也 就 是 这 个 匿名 函数 内 部 的 本 地 变量 ， 当 
匿名 阴 数 外 面 的 colozr 值 发 生变 化 时 ， 本 地 版 的 color 不 会 党 影 啊 。 


代码 清单 3-15 ”用 匿名 曙 数 保留 全 局 变量 的 值 
function asyncFunction(callback) { 
setTimeout (callback, 200),， 
} 


var color = :blue ' 





(function(color) f{ 
asyncFunction(functiont) { 
console.log{('The color is ' + COlor}); 
}) 


}) (color),; 


COlor = 'green'; 


在 Node 开 发 中 你 要 用 到 很 多 JavaScript 编 程 技 巧 ， 这 只 是 其 中 之 一 。 
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闭 包 要 了 解 闭 包 的 详细 信息 ， 请 参见 Mozilla JavaScript 文 档 : https://developer. 
mozilla.org/en-US/docs/JavaScript/Guide/Closures。 
现在 你 知道 怎么 用 闭 包 控制 程序 的 状态 了 , 接 下 来 我 们 看 看 怎么 让 异步 逻辑 顺序 执行 , 好 让 
你 可 以 擎 控 程 序 的 流程 。 


3.3 ”异步 逻辑 的 顺序 化 


在 异步 程序 的 执行 过 程 中 ,有 些 任务 可 能 会 随时 发 生 , 跟 程序 中 的 其 他 部 分 在 做 什么 没关系 ， 
什么 时 候 做 这 些 任务 都 不 会 出 问题 。 但 也 有 些 任务 只 能 在 某 些 特定 的 任务 之 后 做 。 
让 一 组 异步 任务 顺序 执行 的 概念 被 Node 社 区 称 为 流程 控制 。 这 种 控制 分 为 两 类 : 串 行 和 并 行 ， 
如 图 3-9 所 示 。 
囊 行 执行 并 行 执行 












































当 所 有 任务 
结束 后 继续 


然后 任务 3 








在 任务 3 
结束 后 继续 











图 3-9 ” 串 行 的 异步 任务 在 概念 上 跟 同步 逻辑 类 似 ， 然 而 并 行 任务 不 必 一 个 接 一 个 地 执行 


需要 一 个 接 痢 一 个 做 的 任务 叫做 串 行 任务 。 创 建 一 个 目录 并 往 里 放 一 个 文件 的 任务 就 是 串 行 
的 。 你 不 能 在 创建 目录 前 往 里 放 文 件 。 

不 需要 一 个 接着 一 个 做 的 任务 叫做 并 行 任务 。 这 些 任务 彼此 之 间 开 始 和 结束 的 时 间 并 不 重 
有 要， 但 在 后 续 逻 辑 执行 之 前 它们 应 该 全 部 做 完 。 下 载 几 个 文件 然后 把 它们 压缩 到 一 个 zip 归 档 文 
件 中 就 是 并 行 任 务 。 这 些 文件 的 下 载 可 以 同时 进行 ， 但 在 创建 归档 文件 之 前 应 该 全 部 下 载 完 。 

跟踪 串 行 和 并 行 的 流程 控制 要 做 编程 记 账 的 工作 。 在 实现 串 行 化 流程 控制 时 ， 需 要 跟 踩 当前 
执行 的 任务 ,或 维护 一 个 尚未 执行 任务 的 队列 。 实 现 并 行 化 流程 控制 时 需要 跟踪 有 多 少 个 任务 要 
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执行 完成 了 。 

有 一 些 可 以 帮 你 记 账 的 流程 控制 工具 ， 它 们 能 让 组 织 寞 步 的 串 行 或 并 行 化 任务 变 得 很 容易 。 
尽管 社区 创建 了 很 多 序列 化 异步 逻辑 的 辅助 工具 , 但 杀 目 动手 实现 流程 控制 可 以 让 你 看 透 其 中 的 
玄机 ， 让 你 对 如 何 应 对 异步 编程 中 的 挑战 有 更 深 的 认识 。 

本 市 将 癌 你 介绍 下 面 这 些 内 容 : 

口 何 时 使 用 串 行 化 流程 控制 ; 

口 如 何 实 现 串 行 化 流程 ; 

口 如 何 实现 并 行 化 流程 控制 ; 

口 如 何 使 用 第 三 方 模 块 做 流程 控制 。 

接 下 来 我 们 和 完 从 何 时 以 及 如 何在 卉 步 的 世界 中 实现 串 行 化 流程 控制 开始 。 


3.3.1 什么 时 候 使 用 串 行 流程 控制 


可 以 使 用 回调 让 几 个 异步 任务 按 顺 序 执行 , 但 如 果 任务 很 多 ,必须 组 织 一 下 ,否则 过 多 的 回 
调 通 套 会 把 代码 搞 得 很 乱 。 

下 面 这 段 代码 就 是 用 回调 让 任务 顺序 执行 的 。 这 个 例子 用 setTimeout 模 拟 需 要 伦 时 间 执 行 
的 任务 : 第 一 个 任务 用 一 秒 ， 第 二 个 用 半 秒 ， 最 后 一 个 用 十 分 之 一 秒 。setTimeout 只 是 一 个 人 
工 模拟 ， 在 真正 的 代码 中 可 能 是 谈 取 文件 ， 发 起 HTTP 请求 等 。 这 段 代 码 虽 然 不 长 ， 但 它 也 可 以 
算是 比较 乱 的 了 ， 并 且 也 没有 比较 简单 的 染 加 任务 的 办 法 。 

setTimeout (functiont) 1 


Console.l]og('I execute first.');} 
setTimeout {functiont) f 















































console.logt'I execute next.').; 








setTimeout (function() { 
Console.log{'I execute Jast.'); 
ye L003 
}, 500); 
}, 1000); 


此 外 ,你 也 可 以 用 Nimble 这 样 的 流程 控制 工具 执行 这 些 任 务 。Nimble 用 起 来 简单 二 接 ， 并 且 
它 的 代码 量 很 小 〈 经 过 缩小 化 和 压缩 后 只 有 837 个 字 节 )。 下 面 这 个 命令 是 用 来 安装 Nimble 的 : 
npm install nimble 


下 面 的 代码 用 串 行 化 流程 控制 工具 重新 编写 了 前 面 那 段 代码 : 
代码 清单 3-16 用 社区 贡献 的 工具 实现 串 行 化 控制 


var flow = require('nimble'); 














setTimeout (function() { 妆 一 个 地 执行 
console.log('I execute first.'); 
callback(); 
}, 1000); 
}, 


flow.series (I[ re 
function (callback) { 给 Nimble 一 个 函数 数组 ， 让 它 一 个 
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function (callback) { 


setTimeout (function() { 
console.log('I execute next.'); 
callback(); 

}, 500); 


}, 


function (callback) { 


setTimeout (function() { 
console.log('I execute last.'); 
callback().; 

}- OO 


} 
] ); 


尽 
流 
流入 





管 这 种 用 流程 控制 实现 的 版 本 代码 更 多 , 但 通常 可 读 性 和 可 维护 性 更 强 。 你 一 般 也 不 会 一 
程控 制 ， 但 当 碰 到 想 要 驮 开 回 调 藤 套 的 情况 时 ， 它 怠 会 是 改善 代码 可 读 性 的 好 工具 。 
过 这 个 用 特制 工具 实现 串 行 化 流程 控制 的 例子 之 后 ， 我 们 来 看 看 如 何 从 头 开始 实现 它 


直 用 








看 


3.3.2 ”实现 捉 行 化 流程 控制 


为 了 用 品行 化 流程 控制 让 几 个 异步 任务 按 顺 序 执行 , 需要 先 把 这 些 任务 按 预 期 的 执行 顺序 放 
到 一 个 数组 中 。 如 图 3-10 所 示 ， 这 个 数组 将 起 到 队列 的 作用 : 完成 一 个 任务 后 按 顺 序 从 数组 中 取 
四 








按 预期 的 顺序 存在 数组 中 的 任务 








”任务 执行 函数 ， 
”然后 调用 派发 函 
数 执行 队列 中 的 
| 下 一 个 任务 





图 3-10 ” 串 行 化 流程 控制 的 工作 机 制 


数组 中 的 每 个 任务 虱 是 一 个 疯 数 。 任务 完成 后 应 该 调用 一 个 处 理 各 了 痕 数 ,告诉 它 错误 状态 和 
结果 。 如 果 有 错误 ,处理 器 也 数 会 终止 执行 ; 如 果 没 有 错误 ,处 理 器 就 从 队列 中 取出 下 一 个 任务 
执行 它 。 

为 了 演示 如 何 实现 串 行 化 流程 控制 ， 我们 准备 做 个 小 程序 ， 让 它 从 一 个 随机 选择 的 RSS 预 订 
源 中 获取 一 篇 文章 的 标题 和 和 URL， 并 显示 出 来 。RSS 预 订 源 列 表 放 在 一 个 文本 文件 中 。 这 个 程序 
的 输出 是 像 下 面 这 样 的 文本 : 

Of Course ML Has Monads! 

http://lambda-the-ultimate.org/node/4306 
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ee Et 库 中 下 载 两 个 辅助 模块 。 先 打开 命令 行 ， 输入 下 面 的 命令 给 例 
子 创建 个 目录 ， 人 然后 安 儿 辅助 模块 : 


mkdir random story 

cd random story 

npm install regquest 
npm install htmlparser 


request 模 块 是 个 经 过 简化 的 HTTP 客 户 问 ,你 可 以 用 它 获 取 RSS 数 据 。htmlparser 模 块 能 
把 原始 的 RSS 数 据 转换 成 JavaScript 数 据 结 构 。 
接 下 来 在 新 目录 中 创建 一 个 random story.js 文 件 ， 包 含 下 面 的 代码 。 


代码 清单 3-17 在 一 个 简单 的 程序 中 实现 串 行 化 流程 控制 


var fs = regquire('fs'); 
Var request = require('request').; 
Var htmlparser = require('htmlparser'); 
Yar Confiorilename Ss. /ras feeds,txt"; 因 任务 1: 确保 包含 RSS 预 订 
源 URL 列 表 的 文件 存在 
function checkForRSSFile () { 
fs.exists(configFilename, function(exists) { 
if (!exists) 
return next (new Error('Missing RSS file: ' + configrFilename)); 


next (null, configFilename); 
了 只 要 有 错误 就 尽早 返回 
} 


function readRSSrFile (configFilename) { PA 
fs.readFile(configFilename, function(err, feedList) { 任务 2: 读 取 并 解析 包 
if (err) return next (err),; 含 预 订 源 URL 的 文件 


3 1 ~ 
从 预订 源 feedList = feedList 


URL 数 组 中 toString( ) 将 预订 源 URL 列 表 转 换 成 
、 a 5 二 Ar 然 VAN 中 + 
pai .replace(/^\s+|\s+$/g, '') we 然后 分 隔 成 
| J 1J 产 .Split("\n"); 数组 
URL Var random = Math.floor(Math.random()*feedList.1length) 
next (null, feedList[random]|); 
}); 
) 任务 3: 向 选 定 的 预订 源 发 
送 HTTP 请 求 以 获取 数据 ， 
function downloadRSSFeed (feedUrl1l) { 


request({uri: feedUrl}, functionl(err, res, body) 
if {err) return next (err); 
if (res.statusCode != 200) 
return next (new Error('Abnormal response status code')) 





next (null, body).; 
}); 


, 天 | 
function parseRSSFeed (rss) { 到 一 个 条 目 数 组 中 

Var handler = new htmlparser.RssHandler(); 

var parser = new htmlparser.Parser (handler).; 


parser.parseComplete (rss); 
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if (ihandler.dom.items.length) 
return next (new Error('No RSS items ftounaQ' ) ) ; 


如 果 有 数据 ， 显 示 第 一 个 
预订 源 条 目的 标题 和 URL 
var item = handler.dom.items.shift().; 

console.log(item.title).; 

console.log(item.1ink); 


} 


yar ‘Tass | Coee or 把 所 有 要 做 的 任务 按 执行 顺序 添加 
readRSSFile, 到 一 个 数组 中 
downloadRSSFeed, 
parseRSSFeed |];，; 
function next(err, result) { 如 果 任 务 出 错 ， 则 抛 出 异常 
if (err) throw err; 
负责 执行 任 | 
务 的 next Var currentTask = tasks.shift().; 
| : | 从 任务 数组 中 取出 下 个 任务 
函数 if (currentTask) { 
currentTask (result); < 一 执行 当前 任务 
} 
} 
next (); < 一 开始 任务 的 串 行 化 执行 








在 试用 这 个 程序 之 前 , 先 在 程序 脚本 所 在 的 目录 下 创建 一 个 rss_feeds.txt 文 件 。 把 预订 源 URL 
放 到 这 个 文本 文件 中 , 每 行 一 条 。 文 件 创建 好 后 ,打开 命令 行 窗口 输入 下 面 的 命令 进入 程序 所 在 
的 目录 并 执行 脚本 : 


cd random story 
node random story.1js 


如 本 例 中 的 实现 所 示 , 串 行 化 流程 控制 本 质 上 是 在 需要 时 让 回调 进 场 ， 而 不 是 简单 地 把 它们 
黄 侄 起 来 。 
你 已 经 知道 如 何 实现 串 行 化 流程 控制 ,我 们 接 下 来 去 看 看 如 何 让 寞 步 任 务 并 行 执行 。 























3.3.3 ”实现 并 行 化 流程 控制 


为 了 让 异步 任务 并 行 执行 ,仍然 是 要 把 任务 放 到 数组 中 , 但 任务 的 存放 顺序 无 大蒜 要 。 每 个 
任务 都 应 该 调用 处 理 带 胃 数 增加 已 完成 任务 的 计数 值 。 当 所 有 任务 都 完成 后 ,处 理 表 贞 数 应 该 执 
行 后 续 的 逻辑 。 

我 们 会 做 一 个 简单 的 程序 作为 并 行 化 流程 控制 的 例子 , 它 会 读 取 几 个 文本 文件 的 内 容 , 并 输 
出 单词 在 整个 文件 中 出 现 的 次 数 。 我 们 会 用 异步 的 readFile 卫 数 读 取 文 本 文件 的 内 容 ， 所 以 几 
个 文件 的 读 取 可 以 并 行 执行 。 这 个 程序 的 工作 方式 如 图 3-11 所 示 。 

这 个 程序 的 输出 看 起 来 应 该 像 下 面 这 样 ( 尽管 实 际 上 可 能 要 长 很 多 ): 


Would: 2 
wrench: 3 








writeable: 1 
you: 24 
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得 到 目录 中 
的 文件 列表 





用 异步 逻辑 处 理 其 中 的 每 个 文件 
每 个 文件 的 读 取 及 后 续 的 单词 计数 都 是 并 行 完成 的 
人 读 取 文件 | | 读 取 文件 


| 


单词 计数 单词 计数 单词 计数 单词 计数 单词 计数 




































所 有 文件 部 读 取 出 来 
并 完成 单词 的 计数 了 吗 





显示 单词 
的 计数 值 








图 3-11 用 并 行 化 流程 控制 实现 对 几 个 文件 中 单词 频 度 的 计数 


打开 命令 行 窗口 , 输入 下 面 的 命令 创建 两 个 目录 : 一 个 是 给 我 们 这 个 例子 用 的 , 男 一 个 是 
来 存放 要 分 析 的 文本 文件 的 。 


mkdir word count 





cd word count 
mkdir text 


接 下 来 在 word_count 目 录 下 创建 word_count.js 文 件 ， 放 入 下 面 代 码 清 单 中 的 代码 。 
代码 清单 3-18 ”在 一 个 简单 的 程序 中 实现 并 行 化 流程 控制 








Var fs = require('fs'); 
var completedTasks = 0; 
var tasks = []; 

var wordCounts = {}; 

Var filesDir = './text',; 


funcetion checekIitComoletel(}) 4 当 所 有 任务 全 部 完成 后 ， 列 出 
completedTasks++; 文件 中 用 到 的 每 个 单词 以 及 用 
if (comletedrasks == tasks. length}) { 了 多 少 次 

for (var index in wordCounts) { 
console.log(index +': ' + wordCounts[index]); 
} 
} 
| 
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function countWordsInText (text) { 
var words = text 
.toString!() 
.toLowerCase() 
.Split(/\W+/) 
.Sort(); 因 对 文本 中 出 现 的 单词 计数 
for (var index in words) { 
var word = words[index]; 
1if (word) { 
wordCounts[word] = 
(wordCounts[word]) ? wordCounts[word] + 1 : 工 ; 
} 
} 


} | 得 出 text 目 录 中 的 文件 列表 
fs.readdir (filesDir, function(err, files) f{ 


if (err) throw err; 
for(var index jin files) { 
1 





var task = (function(file) { We 定义 处 理 每 个 文件 的 任务 .每 个 
return function() { pu 六 sa ea 
fs.readFile(file, function(err, text) { ed 0 
if (err) throw err; 人 和 
CountWordsInText (text).;} 单词 计数 
checkIfCompletel().; 
}); 
. 把 所 有 任务 都 添加 到 函数 调用 
}) (fijlesDir + '/' + filesl[lindex]):; 数组 中 
tasks.push (task).; 
} 
for(var task in tasks) f{ 
tasks [task] (}; 开始 并 行 执行 所 有 任务 
} 


12S 
在 试用 这 个 程序 之 前 ， 先 在 前 面 创建 的 text 目 录 中 创建 一 些 文 本 文件 。 在 创建 了 这 些 文件 之 
后 ， 打 开 一 个 命令 行 窗口 ， 输 入 下 面 的 命令 进入 程序 所 在 目录 并 执行 程序 脚本 : 


Cd word_count 
node word _ count.Is 


现在 你 已 经 知道 串 行 和 并 行 化 流程 控制 的 的 层 机 制 了 , 接 下 来 我 们 要 看 看 如 何 用 社区 页 献 的 
工具 在 程序 中 轻松 实现 流程 控制 ， 而 不 必 目 己 杀 目 实 现 。 








3.3.4 利用 社区 里 的 工具 
社区 中 的 很 多 附加 模块 都 提供 了 方便 好 用 的 流程 控制 工具 。 其 中 比较 流行 的 有 Nimble 、Step 
和 Seq 三 个 。 尽 管 这 些 都 很 值得 一 看 ， 但 下 面 这 个 例子 用 的 还 是 Nimble。 

社区 中 有 流程 控制 能 力 的 附加 模块 ”要 了 解 更 多 与 社区 中 有 流程 控制 能 力 的 附加 
模块 相关 的 内 容 ， 请 阅读 Werner Schuster 和 Dio Synodinos 在 InfoQ 上 发 表 的 文章 “虚拟 座 
谈 : 如 何 从 JavaScript 异 步 编 程 中 活 下 来 ” http:/mng.bz/wKnV 。 
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下 面 这 个 例子 是 用 Nimble 实 现任 务 序列 化 的 一 段 脚 本 , 它 同时 用 并 行 化 流程 控制 下 载 两 个 文 
件 ， 然 后 把 它们 归档 。 


下 面 这 个 例子 在 微软 的 Windows 中 无 法 使 用 因为 Windows 中 没有 tar 和 curl 这 两 
个 命令 ， 所 以 下 面 这 个 例子 在 Windows 中 无 法 使 用 。 
在 这 个 例子 中 我 们 用 串 行 化 控制 保证 在 下 载 完 成 之 前 不 会 对 文件 做 归档 处 理 。 
代码 清单 3-19 在 简单 的 程序 中 使 用 社区 附加 模块 中 的 流程 控制 工具 


var flow = require('nimble') 
Var exec = require('child process') .exec; 





function downloadNodeVersion(version, destination, callback) { 


Var url = 'http://nodejs.org/dist/node-v' + Vversion + '.tar.gz'; 
Var filepath = destination + '/' + Version + '.tgz'; 
exec('curl ' + url + ' >' + filepath, callback).; . 、 
} 下 载 指 定 版 本 的 Node 源 码 
flow.series(lI 
es 按 顺序 执行 串 行 化 任务 
flow.parallell(l[ 


function (callback) { 
console.log('Downloading Node v0.4.6...'); 
downloadNodeVersion('0.4.6', '/tmp', callback).; 
}, 
function (callback) { 
console,l1og{('Downloading Node vO.4.7...'): 


并 行 下 载 


downloadNodeVersicon('0.4.7', '/tmp', callback); 
} 
] Tallback): 
ja 
Fametion(eallback) 9 创建 归档 文件 
console.log('Creating archive of downloaded files...'); 
exec 


'tar cvft node distros.tar /tmp/0.4.6.tgz /tmp/0.4.7 .tgz', 
function(lerror, stdout, stderr) { 

console.log(t'All donel!l'}; 

callback!().; 





je 
} 
] ); 


这 上段 脚本 中 定义 了 一 个 可 以 下 载 指定 版 本 Node 源 码 的 辅助 函数 。 然 后 串 行 执行 了 两 个 任务 : 
并 行 下 载 两 个 版 本 的 Node， 然 后 将 下 载 好 的 版 本 归档 到 一 个 新 文件 中 。 


3.4 ”小 结 











本 章 介 绍 了 如 何 将 程序 的 逻辑 组 织 成 可 重用 的 模块 ， 以 及 如 何 让 异步 逻辑 按 你 想 要 的 方式 
执行 。 
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Node 的 模块 系统 基于 CommonJS 模 块 规范 (www.commonjs.org/specs/modules1.0/ )， 你 可 以 
通过 组 装 exports 和 module .exports 轻 松 重 用 模块 。 当 你 在 程序 代码 中 require 模 块 时 , 模块 
的 查找 系统 会 在 儿 个 位 置 上 查找 它们 , 很 灵活 。 除了 可 以 把 模块 放 到 程序 的 源码 树 中 ,还 可 以 用 
node modules 文 件 夹 在 几 个 程序 间 分 享 模块 代码 。 在 模块 被 引用 时 ， 在 模块 内 部 的 package.json 
文件 可 以 用 来 指明 先 计 算 模 块 源码 树 中 的 哪个 文件 。 

你 可 以 用 回调 、 事 件 发 射 希 和 流程 控制 管理 异步 逻辑 。 回 调适 用 于 一 次 性 异步 逮 辑 , 但 使 用 
它们 需要 注意 别 把 代码 摘 乱 。 事 件 发 射 硕 对 组 织 异 步 逻 辑 很 有 大助 , 因为 它们 可 以 把 异步 逻辑 跟 
一 个 概念 实体 关联 起 来 ， 可 以 通过 监听 器 轻松 管理 。 

流程 控制 可 以 管理 异步 任务 的 执行 顺序 ,可 以 让 它们 一 个 接 一 个 执行 , 也 可 以 同时 执行 。 你 
可 以 自己 实现 流程 控制 , 但 社区 附加 模块 可 以 帮 你 解决 这 个 有 厂 烦 。 选 择 哪个 流程 控制 附加 模块 很 
大 程度 上 取决 于 个 人 喜好 以 及 项 目 或 设计 的 需要 。 

现在 这 一 草 已 经 结束 了 ， 开 发 前 最 后 的 准备 工作 也 做 好 了 ， 接 下 来 你 可 以 去 尝试 一 下 Node 
最 重要 的 特性 之 一 : 它 的 HTTPAPI。 在 下 一 章 中 ， 你 将 学 到 使 用 Node 开 发 Web 程 序 的 基础 知识 。 
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用 Node 开发 Web 程 友 





Node 内 管 的 HTTP 功 能 使 得 它 非常 适合 用 来 开发 Web 程 序 。Node 用 得 最 多 的 就 是 做 这 种 开 
发 ， 这 也 和 是 本 书 第 二 部 分 的 重点 。 

我 们 一 开始 先 学 习 如 何 使 用 Node 内 置 的 HTTP 功 能 。 然 后 学 习 如 何 用 中 间 件 添加 更 多 功能 ， 
比如 处 理 表单 提交 的 数据 。 最 后 学 习 如 何 使 用 流行 的 Express Web 框 架 加 快 你 的 开发 速度 ， 以 及 
如 何 部 署 创建 好 的 程序 。 
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构建 Node Web 程 序 





本 章 内 容 

口 用 Node 的 API 处 理 HTTP 请 求 
口 构建 一 个 RESTful Web 服 务 

口 提供 静态 文件 服务 

口 接受 用 户 在 表单 中 输入 的 数据 
口 用 HTTPS 加 强 程 序 的 安全 性 





本 章 将 问 你 介绍 Node 为 创建 HTTP 服 务 器 所 提供 的 工具 ， 还 有 fs ( 文件 系统 ) 模块 ， 它 是 提 
供 静 态 文 件 服务 的 必 备 模块 。 你 还 将 学 会 如 何人 处 理 其 他 常见 的 Web 程 序 需求 ， 比 如 创建 底层 的 
RESTful Web 服 务 ， 接 受用 户 通 过 HTML 表 单 输入 的 数据 ， 监 测 文 件 上 传 进度 ， 以 及 用 Node 的 安 
全 套 接 字 层 (SSL ) 增强 Web 程 序 的 安全 性 等 。 

Node 的 核心 是 一 个 强大 的 流 式 HITP 解 析 硕 ， 大 概 由 1500 行 经 过 优化 的 C 代 码 组 成 ， 是 Node 
的 作者 Ryan Dahl 写 的 。 这 个 解析 磊 跟 Node 开 放 给 JavaScript 的 底 屋 TCP API 相 结合 ， 为 你 提供 了 
一 个 非 党 底层， 但 也 非常 灵活 的 HITP 服 务 需 。 

跟 Node 的 大 多 数 核心 模块 一 样 ，http 模 块 也 很 简单 。 高 层 的 “ 含 糖 ”API 被 留 给 了 Connect 
或 Express 这 样 的 第 三 方 框架 ， 这 样 极 大 地 简化 了 了 Web 程序 的 构建 过 程 。 图 4-1 给 出 了 Node Web 程 
序 的 内 部 结构 ， 其 核心 为 底层 API， 而 抽象 层 和 实现 层 则 构建 在 那些 核心 构件 之 上 。 

本 草 介 绍 的 是 Node 的 一 些 底 层 API。 如 果 你 只 对 更 高 层 的 概念 和 Connect 或 Express 这 样 Web 
框架 感 兴趣 ,可 以 直接 跳 过 本 章 ， 去 后 续 草 市 中 学 习 相 关内 容 。 但 在 用 Node 构 建功 能 丰富 的 Web 
程序 之 前 ， 你 应 该 熟知 它 的 HTTP API， 这 是 构建 更 高 层 工 具 和 框架 的 基础 。 



































4.1 HTTP 服务 器 的 基础 知识 


就 像 我 们 在 本 书 中 一 再 提 及 的 那样 ，Node 的 API 相 对 来 说 比较 底层 。 跟 PHP 之 类 的 语言 或 其 
他 框 涤 相 比 ，Node 的 HTTP 接 口 一 样 比较 奔 层 ， 不 过 这 是 为 了 保证 它 的 速度 和 灵活 性 。 
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duerystring 
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net 


VD Node 的 核心 API 都 是 轻 量 和 底层 的 。 @ 应 用 返 辑 层 古 由 你 的 程序 实现 
而 想法 、 语 法 糖 和 具体 细 市 这 些 就 的 。 这 一 层 的 大 小 是 由 你 所 用 
交 给 社区 模块 去 实现 了 的 社区 模块 数量 ， 以 及 程序 的 


复杂 程度 决定 的 

| 社区 模块 是 Node 最 兴盛 的 部 分 。 社 
区 成 员 们 利用 底层 核心 API 创 建 出 有 
帮 有 你 把 任务 轻松 
高 定 


图 4-1 Node Web 程序 分 层 概览 
为 了 让 你 能 创建 出 既 健 壮 又 高 效 的 Web 程 序 ， 本 节 将 重点 讨论 下 面 这 些 内 容 : 
口 Node 如 何 疝 开发 者 呈现 HTTP 请 求 ; 
口 如 何 编 写 一 个 人 简单 的 HTTP 服 务 硕 ， 用 “Hello World” 做 啊 应 ; 
口 如 何 读 取 请 求 涉 ， 以 及 如 何 设 置 响应 头 ; 
口 如 何 设置 HTTP 响 应 的 状态 码 。 
在 你 能 够 接受 请 求 之 前 ,需要 先 创建 一 个 HITTP 服 务 融 。 接 下 来 我 们 看 一 看 Node 的 HTTP 接口 。 








4.1.1 ” Node 如何 回 开发 者 呈现 HTTP 请 求 
Node 中 的 http 模 块 提 供 了 HTTP 服 务 器 和 客户 端 接口 : 


Var http = regquire('http'); 





创建 HTTP 服 务 右 要 调用 http .createServer () 困 数 。 它 只 有 一 个 参数 ， 是 个 回调 尊 数 ， 
服务 器 每 次 收 到 HTTP 请 求 后 都 会 调用 这 个 回调 陶 数 。 这 个 请 求 回调 会 收 到 两 个 参数 ， 请 求 和 响 
应 对 象 ， 通 常 简 写 为 req 和 res: 
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Var http = require('http'); 


Var Server = http.createServer (functionl(reg, res)f 
// 处 理 请 求 
} 





服务 姨 每 收 到 一 条 HTTP 请 求 ， 都 会 用 新 的 req 和 和 res 对象 触发 请 求 回 调 函 数 。 在 触发 回调 也 
数 之 前 ，Node 会 解析 请 求 的 HTTP 头 ， 并 将 它们 作为 req 对 和 象 的 一 部 分 提供 给 请 求 回调 。 但 Node 
不 会 在 回调 函数 被 触发 之 前 开始 对 请 求 体 的 解析 。 这 种 做 法 跟 某 些 服务 端 框 染 不 同 ， 比 如 PHP 就 
是 在 程序 逻辑 运行 前 就 把 请 求 头 和 请 求 体 都 解析 出 来 了 。Node 提 供 了 这 个 底层 接口 , 所 以 如 果 你 
想 的 话 ， 可 以 在 请 求 体 正 被 解析 时 处 理 其 中 的 数据 。 

Node 不 会 自动 往 客 户 端 写 任 何 响应 。 在 调用 完 请 求 回调 函数 之 后 ,就 要 由 你 负责 用 res .end () 
方法 结束 响应 了 见 图 4-2 )。 这 样 在 结束 响应 之 前 ， 你 可 以 在 请 求 的 生命 期 内 运行 任何 你 想 运 行 的 
异步 逻辑 。 如 有 果 你 没 能 结束 响应 ,请求 会 挂 起 ， 和 直到 客户 端 超时 ， 或 者 它 会 一 直 处 于 打开 状态 。 


























Web 训 览 右 


HTTP 客 户 端 ， 比 如 Web 浏 览 器 ， 
发 起 了 一 个 HITP 请 求 。 





多 Node 接 受 连 接 ， 以 及 发 送 
给 HTTP 服 务 如 的 请 求 数据 。 


GER HETRAL.L 


HTTP/1.1 200 OK HTTP 服 务 咒 解析 完 HITP 头 ， 
Hello World 将 控制 权 转 交 给 请 求 回 调 函 数 。 


(人 请 求 回 调 执行 应 用 逻辑 ， 
在 这 里 是 立即 用 文本 “Hello World.” 
作为 啊 应 。 

HTTP 服 务 妖 


http.createServer (cb) ; 


全 吧 应 通过 HITIP 服 务 缘 运 回去 ， 
由 它 为 客户 端 构造 格式 正确 的 HITP 啊 应 。 


请 求 回调 


function cb (req, res) { 
res.end(' Hello World’);} 
} 





图 4-2 ”Node HTTP 服务 器 上 的 整个 HTTP 请 求生 命 周 期 


Node 服 务 融 是 长 期 运行 的 进程 ， 在 它 的 整个 生命 期 里 ， 它 会 处 理 很 多 请 求 。 
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4.1.2 一 个 用 “Hello World” 做 响应 的 HTTP 服 务 器 


为 了 实现 这 个 简单 的 Hello World HTTP 服务 硕 ， 我 们 把 上 一 节 那 个 请 求 回调 函数 十 上 。 
首先 调用 res .write() 方 法 ,将 啊 应 数据 写 到 socket 中 , 然后 用 res .enda() 方 法 结束 这 个 啊 应 : 


var http = require('http'); 








Var server = http.createServer (functionlreg, res)f 
res.write('Hello World'); 
res.end!{l); 


I 

res.write() 和 tres.end() 可 以 合 起 来 缩写 成 一 条 语句 , 这 样 对 于 小 型 的 啊 应 来 说 很 方便 : 

res.end!{('Hello World'}).: 

你 要 做 的 最 后 一 件 事 是 绑 定 一 个 端口 ， 让 服务 大 可 以 监听 接 入 的 请 求 。 这 要 用 到 
server.1Listen() 方 法 ， 它 能 接受 一 个 参数 组 合 ， 但 眼下 我 们 需要 的 是 指定 一 个 能 监听 连接 的 
疾 口 。 在 开发 过 程 中 一 般 是 绑 定 到 一 个 非特 权 冰 口上 ， 比 如 3000: 


var http = require('http'); 














Var server = http.createServer (functionlregq, res)f 
res.end{'Hello World').: 
2 


server.listen(3000); 

让 Node 监 听 了 端口 3000 之 后 ， 你 可 以 在 浏览 硕 中 访 问 http:/localhost:3000。 然 后 你 应 该 能 看 
到 一 个 包含 “Hello World.” 的 普通 文本 页 面 。 

搭建 HTTP 服务 需 仅 仅 是 个 开始 。 你 还 需要 知道 如 何 设 定 啊 应 状态 码 和 响应 头 中 的 字段 ， 如 
何 正 确 处 理 异常 ， 以 及 如 何 使 用 Node 提 供 的 API。 我 们 先 来 深入 了 解 下 如 何 响应 接 入 的 请 求 。 


4.1.3 读 取 请 求 头 及 设 定 啊 应 头 


上 上 一方 的 Hello World 服 务 硕 回 我 们 展示 了 给 出 正确 的 HITP 啊 应 所 需 的 最 低 要 求 。 它 用 了 黑 
认 的 状态 码 200 ( 表明 成 功 ) 和 黑 认 的 啊 应 头 。 尽 管 通 稍 你 会 想 要 在 啊 应 中 放 人 任意 数量 的 啊 应 
头 。 比 如 在 发 送 HTML 内 容 时 ， 必 须发 送 一 个 值 为 Ltext/html 的 content-Type 头 ， 计 浏览 各 和 若 
道 要 把 啊 应 结果 作为 HTML 演 染 。 

Node 提 供 了 几 个 修改 HITP 啊 应 凑 的 方法 : res. setHeader (field, value) res.getHeader (fieldqd) 
res .removeHeader (fieldq) 。 这 里 有 个 使 用 res .SetHeader ( ) 的 例子 : 




















var body = 'Hello World'. 
res.setHeader ('Content-Length', body.length); 
res.setHeader('Content-Type', 'text/plain'): 


res.end'l(lbody}.; 
添加 和 移 除 啊 应 头 的 顺序 可 以 随意 ， 但 一 定 要 在 调用 res .write() 或 res .end() 之 前 。 在 
响应 主体 的 第 一 部 分 写 人 之后，Node 会 刷新 已 经 设 定好 的 HTTP 头 。 





4.1.4 设 定 HTTP 响 应 的 状态 码 
我 们 经 常 需要 返回 默认 状态 码 200 之 外 的 HTTP 状 态 码 ,比较 常见 的 情况 是 当 所 请 求 的 资源 不 
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存在 时 返回 一 个 404 Not Found 状 态 码 。 

这 要 设 定 res .statuscode 属 性 ,。 在 程序 啊 应 期 间 可 以 随时 给 这 个 属性 赋值 ， 只 要 是 在 第 一 
人 次 调用 res .write() 或 res .end() 之 前 就 行 。 如 下 例 所 示 ， 这 意味 痢 res.statusCode = 302 
可 以 放 在 res .setHeader() 调 用 上 面 ,也 可 以 在 它们 下 面 : 


var url = 'http://google.com',; 
Var body = '<p>Redirecting to <a href="' + Url + ">! 
+ url + '</a></p>'; 


res.setHeader('Location', url).; 
res.setHeader('Content-Length', body.length)}:; 
res.setHeader('Content-Type', 'text/html'}): 
res.statusCode = 302， 

res.end (body)},; 


Node 的 策略 是 提供 小 而 强 的 网 络 API， 不 去 跟 Rails 或 Django 之 类 的 框架 竞争 ， 而 是 作为 类 似 
框架 构建 基础 的 巨大 平台 。 因 为 有 这 种 设计 理念 ， 像 会 话 这 种 高 级 概念 以 及 HTTP cookies 这 样 的 
基础 组 件 都 没有 包括 在 Node 的 内 核 之 中 。 那 些 都 要 由 第 三 方 模块 提供 。 

你 已 经 见 过 基本 的 HTTP API 了 ， 现 在 可 以 把 它们 投入 使 用 了 。 在 下 一 节 中 ， 你 将 使 用 这 些 
API 做 一 个 简单 的 、HTTP 兼 容 的 程序 。 




















4.2 构建 RESTful Web 服务 


假设 你 想 用 Node 创 建 一 个 待 办 事项 清单 的 Web 服 务 , 涉及 到 典型 的 创建 、 读 取 、 更 新 和 删除 
(CRUD ) 操作 。 这 些 操 作 的 实现 方式 有 很 多 种 ,但 本 市 要 创建 一 个 RESTful Web 服 务 ， 一 个 使 用 
HTTP 方 法 谓词 提供 精 傈 API 的 服务 。 

HTTP 1.0 和 1.1 规 范 的 突出 贡献 者 之 一 ，Roy Fielding 博 士 在 2000 年 提出 了 表征 状态 转移 
(REST ) ?。 依 照 惯例 ，HTTP 谓 词 ， 比 如 cET、POST、PUT 和 DELETE， 分别 跟 由 URL 指 定 的 资源 
的 获取 、 创 建 、 更 新 和 移 除 相 对 应 。RESTfl Web 服 务 之 所 以 得 以 流行 ,是 因为 它们 的 使 用 和 实现 
比 简 单 对 象 访 问 协议 (SOAP ) 之 类 的 协议 更 简单 。 

本 节 会 用 cURL ( http://curl.haxx.se/download.html ) 代替 Web 浏 览 套 跟 Web 服 务 交 互 。cURL 
是 一 个 强大 的 命令 行 HTTP 客 户 端 ， 可 以 用 来 回 目标 服务 大 发 送 请 求 。 

创建 标准 的 REST 服 务 需 需 要 实现 四 个 HTTP 谓 词 。 每 个 谓词 会 覆盖 一 个 待 办 事项 清单 的 操作 
任务 : 

口 PoST ”问答 办 事项 清单 中 添加 事项 ; 

口 GET 显示 当前 事项 列表 ， 或 者 显示 某 一 事项 的 详情 ; 

D DELETE 从 竺 办 事项 清单 中 移 除 事项 ; 

口 PUT 修改 已 有 事项 ， 但 为 了 人 简洁 起 见 ， 本 草 会 跳 过 PUT。 























Q) Roy Thomas Fielding, “架构 风格 与 基于 网 络 的 软件 架构 设计 ”( 博士 论文 ， 加 州 大 学 Irvine 分 校 ，2000 年 )， 原 文 : 
www.ics.uci.edu/~fielding/pubs/dissertation/top.htm, 中 文 PDF 下 载 : mysql-udf-http.googlecode.com/files/REST _cn.pdf 
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我 们 先 来 看 一 下 最 终结 果 是 什么 样子 ， 这 里 有 个 一 用 cuzr1 命 令 在 生 办 事项 清单 中 创建 新 事 
项 的 例子 : 





wavdedQ@dev: 


wavded@ ~» cuUrl -d “buy node in action” http://localhost:3000 
OK 


这 里 还 有 一 个 碍 看 竺 办 事项 清单 中 事项 的 例子 : 











wavdedQ@dev: 


wavded@ ~» curl http://localhost:3000 
0) buy node in action 


4.2.1 用 POST 请 求 创 建 资源 


按 RESTful 的 说 法 ， 资 源 的 创建 通常 是 跟 谓词 POST 对 应 的 。 因 此 POST 将 在 待 办 事项 清单 中 
创建 一 个 事项 。 

在 Node 中 ， 可 以 通过 检查 req .method 属 性 查看 用 的 是 哪个 HTTP 方 法 ( 谓词 ) ( 如 代码 清单 
4-1 所 示 )。 知 道 请 求 用 的 是 哪个 方法 ， 服 务 需 就 能 知道 要 执行 哪个 任务 。 

当 Node 的 HTTP 解 析 需 读 入 并 解析 请 求 数 据 时 , 它 会 将 数据 做 成 aata 事 件 的 形式 ， 把 解析 好 
的 数据 块 放 入 其 中 ， 等 待 程序 处 理 : 




















| El 
var server = http.createServer (function(reg, res)t 触发 qata 事 件 
req.on('data', function (chunk)t 
console., Log(”"parsed’y chunk)’; 数据 块 默认 是 个 Buffer 对 
站 象 〈 字 节 数 组 ) 
req.on('end', function()t 
console.log('done parsing'); 数据 全 部 读 完 之 后 触发 
res.end ( ) end 事 件 


}); 
}); 


默认 情况 下 ，qata 事 件 会 提供 Buffer 对 象 ， 这 是 Node 版 的 字 节 数组 。 而 对 于 文本 格式 的 待 
办 事项 而 言 ， 你 并 不 需要 二 进 制 数据 ， 所 以 最 好 将 流 编码 设 定 为 ascii 或 utf8; 这 样 aata 事 件 
会 给 出 字符 串 。 这 可 以 通过 调用 req .setEncoding (encoding) 方 法 设 定 : 


req.setEncoding('utf8') 现在 的 数据 块 不 再 是 Buffer 
req.on('data', function(chunk)t 对 象 ， 而 是 一 个 utf8 字 符 串 


Console.1log (chunk); 


I 

在 将 待 办 事项 添加 到 数组 中 之 前 ,你 需要 得 到 完整 的 字符 串 。 要 得 到 整个 字符 串 , 可 以 将 所 
有 数据 块 拼接 到 一 起 ， 耳 到 表明 请 求 已 经 完成 的 end 事 件 被 发射 出来。 在 eng 事 件 出 来 后 ， 可 以 
用 请 求 体 的 整 块 内 容 组 装 出 item 字 符 串 , 然后 压 人 items 数 组 中 。 在 添加 好 事项 后 , 你 可 以 用 字 
符 串 OK 和 Node 的 默认 状态 码 200 结 束 啊 应 。 正 如 下 面 这 段 来 自 todo.js 文 件 的 代码 清单 所 示 : 
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代码 清单 4-1 POST 请 求 体 字符 串 缓存 


var http = require('http'); 





Var url = requirel('url'); 用 一 个 常规 的 JavaScript 
Var items = [|]; 数组 存放 数据 
为 进来 的 事 os 
项 设置 字符 | Var Server = http.createServer (function(req, res)t req.method 是 请 求 所 
串 缓 存 Switel (Ted method) 4 用 的 HTTP 方 法 
Case 'POST': 
L > Var item = '',;， 
req.setEncoding('utf8').; 
yJ 各、 SI 
red.onl 'dqata'，functionl(chunk) { 将 进来 的 data 事 件 编 
item += chunk.; 码 为 UTF-8 字 符 串 
人 
将 类 二 | 
J req.on('end', function()t 
组 仔 
ltems.push (item).;} 
J 多 空 ' 束 食 站 3 E 
上 数组 中 
break,; 


} 
}); 


图 4-3 是 HTTP 服 务 带 处 理 接 入 请 求 并 在 请 求 结束 之 前 缓存 输入 的 过 程 。 
服务 器 


L | 


var ltem = 57) 


data 工 之 后 ， 


item =='He' 


和 Ea 


item == 'Hell' 


SF 


ijtem == 'Hellol!' 


end 之 后 : 
得 到 完整 的 请 求 体 :'Hello! 


Can now add to items list 





带 有 请 求 体 的 
HTTP 请 求 











图 4-3 ”拼接 gata 事 件 以 缓存 请 求 体 


现在 这 个 程序 可 以 浴 加 事项 ， 但 在 用 cURL 试 验 它 之 前 ， 你 应 该 乞 做 完 下 一 个 任务 ， 以 便 能 
得 到 事项 清单 。 
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4.2.2 ”用 GET 请 求 获取 资源 


为 了 处 理 GET， 要 像 前 面 那样 把 它 添加 到 switch 语 名 中 ， 再 加 上 列 出 竺 办 事项 的 逻辑 。 在 
下 面 这 个 例子 中 ， 第 一 次 调用 res .write() 时 会 写 入 市 有 软 认 堪 的 啊 应 头 和 传 给 它 的 数据 : 


心肌 号 全 GET: 





items.forEachifunction(item, 1)f{ 
res.write(i + ') "+ item + '\n'); 

1) ; 

res.end!().; 

break,; 








现在 这 个 程序 能 显示 待 办 事项 ， 可 以 试 一 下 了 1 打开 终端 ， 局 动 服务 船用 cur1 POST 一 些 
事项 。 选 项 -da 会 目 动 将 请 求 方法 设 定 为 PosST， 并 将 参数 值 作为 PosT 数 据 传人 : 

$s curl -d 'lbuy groceries' http://localhost:3000 

OFK 


$s curl -d 'buy node in action' http://localhost:3000 
OK 


接 下 来 ， 要 GET 竺 办 事项 清单 ， 可 以 执行 不 市 任何 选项 的 curl， 因 为 GET 是 殉 认 的 谓词 : 


$ curl http://localhost:3000 
0) buy groceries 
1) buy node in action 


设 定 Content-Length 头 

为 了 提高 啊 应 速度 ， 如 果 可 能 的 话 ， 应 该 在 啊 应 中 带 着 content-Length 域 一 起 发 送 。 对 于 
事项 清单 而 言 , 啊 应 主体 很 容易 在 内 存 中 提前 构建 好 , 所 以 你 能 得 到 字符 串 的 长 度 并 一 次 性 地 将 
整个 清单 发 出 去 。 设 定 Content-Length 域 会 隐 舍 禁用 Node 的 块 编码 ， 因 为 要 传输 的 数据 更 少 ， 
所 以 能 提升 性 能 。 

经 过 优化 的 GET 处 理 需 可 能 是 下 面 这 样 的 : 

var body = items.maplfunction(item, 1}{ 

return i + '}) ' + item; 
PLT 
res.setHeader'('Content-Length', Buffer.byteLength podqy) ) ; 


res.setHeader('Content-Type', 'text/plain; charset="utf-8"'),; 
res.end(body); 


你 可 能 想 用 body .length 的 值 设 定 Content-Length,， 但 content-Length 的 值 应 该 是 字 
节 长 度 , 不 是 字符 长 度 ， 并 且 如 果 字 符 串 中 有 多 字 节 字符 ， 两 者 的 长 度 是 不 一 样 的 。 为 了 规避 这 
个 问题 ，Node 提 供 了 一 个 Buffer.byteLength() 方 法 。 












































下 面 这 个 Node REPL 会 话 曾 明了 直接 使 用 字符 串 长 度 的 差异 ，5 个 字符 的 字符 串 有 7 个 学 市 : 
node 
-etc ..' .length 


S$ 
> 
5 
> Buffer.byteLength{'etc ..') 
7 
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Node 的 REPL 

Node 跟 很 多 其 他 语言 一 样 ， 提 供 了 一 个 REPL ( 读 取 -计算 -输出 -循环 ) 环境 ， 在 命令 和 

中 不 带 任 何 参 数 运行 node 就 可 以 进入 这 个 环境 。 用 REPL 可 以 编写 代码 片段 ， 每 条 语句 写 好 jj 
执行 后 马上 就 能 得 到 结果 。 对 于 学 习 编 程 语言 、 运 行 简单 的 测试 ， 甚 至 是 调试 都 很 有 帮助 。 


\ 


2 


滔 


4.2.3 用 DELETE 请 求 移 除 资 源 


最 后 是 用 DELETE 移 除 事项 。 为 了 完成 这 个 任务 ， 程 序 需要 检查 请 求 的 URL，HTTP 客 户 端 
会 在 其 中 指明 要 移 除 哪个 事项 。 在 这 个 例子 中 用 的 是 事项 数组 中 的 索引 ， 比 如 DELETE /1 或 
DELETE /5。 

redq.uxr1 属 性 中 就 有 客户 端 请 求 的 UREL， 根 据 请 求 的 不 同 ， 其 中 可 能 包含 几 个 组 成 部 分 。 比 
如 说 ， 如 果 请 求 是 DELETE /1?api-key=foobar ， 这 个 属性 会 包含 路 径 名 及 请 求 字 符 串 
/1?api-key=foobar 两 部 分 。 

为 了 解析 这 些 部 分 ，Node 提 供 了 ur1 模 块 ， 特 别 是 .parse() 困 数 。 下 面 的 REPL 会 话 前 明了 
这 个 函数 的 用 法 ,将 URL 解 析 到 一 个 对 象 中 ， 包 括 要 用 在 DELETE 处 理 带 中 的 pathname 属 性 。 


S node 
> require('url') .parse('http://localhost:3000/1?api-key=foobar') 
{ Protocol: 'http:', 
slashes: true, 
host: 'lJocalhost:3000', 
Port: '3000°', 
hostname: 'localhost', 
href: 'http://localhost:3000/1?api-key=foobar’', 
search: '?apli-key=foobar', 
Guery: 'api-key=foobar’, 
pathname: '/1', 
path: '/l1?api-key=foobar' } 


url .parse() 只 能 帮 你 解析 出 pathname, 但 事项 ID 仍然 是 字符 串 。 要 在 程序 中 使 用 这 个 ID ， 






































符 索 引 之 间 的 部 分 。 在 这 里 可 以 用 它 跳 过 第 一 个 字符 ， 只 返回 数字 部 分 , 不 过 它 的 返回 结果 还 是 
字符 串 。 要 把 这 个 字符 串 转 换 为 数字 ， 可 以 把 字符 串 传 给 JavaScript 的 全 局 果 数 parseInt()， 它 
会 返回 一 个 Number。 

代码 清单 4-2 先 对 输入 值 做 了 两 项 检查 ， 因 为 你 永远 不 能 相信 用 户 输 入 数据 的 有 效 性 ， 然 后 
它 对 请 求 做 出 了 啊 应 。 如 果 这 个 数字 是 “ 非 数 字 ”( JavaScript 值 NaN )， 状 态 码 会 被 设 定 成 400， 
表明 这 是 一 个 坏 请 求 。 接 着 是 检查 事项 是 否 存 在 的 代码 ， 如 果 不 存 在 就 用 404 Not Found 做 啊 应 。 
在 输入 经 过 验证 确认 为 有 效 后 ， 事 项 会 从 事项 数组 中 移 除 ， 然 后 程序 用 200, OK 响应 客户 端 。 
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代码 清单 4-2 DELETE 请 求 处 理 需 


Case ‘'DELETE': ee | pe 
var path = url.parse (req.url) .pathname; + switch 扣 RITAR 
var 1 = parseIntlipath,slice(1), 10)s 加 DELETE case 


if (isNaN(i)) { 

res.statusCode = 400; | 检查 数字 是 否 有 效 
res.end('Invalid item id'); 

else if (!items[1]) { 

res.statusCode = 404; | 确保 请 求 的 索引 存在 
res.end('Item not found'); 

else { 

items.splice(i, 1).; 


Se 删除 请 求 的 事项 


oo 


| 


} 
break; 








你 可 能 党 得 从 数组 中 移 除 一 个 条 目 就 要 用 15 行 代码 有 点 太 多 了 ，, 但 我 们 可 以 向 你 保证 , 这 个 
用 局 层 框 染 中 含 糖 量 更 局 的 API 做 起 来 要 容易 得 多 。 学 习 Node 的 这 些 基础 知识 对 于 你 的 理解 和 调 
试 至 关 重 要 ， 并 且 它 还 能 让 你 创建 出 更 强大 的 程序 和 框 染 。 

一 个 完整 的 RESTful 服 务 还 应 该 实现 PUT 谓词 ， 用 来 修改 符 办 事项 清单 中 的 已 有 事项 。 在 你 
进入 下 一 节 之 前 ， 我 们 和 硕 望 你 能 试 春 用 之 前 在 这 个 REST 服 务 带 中 使 用 的 技术 目 己 实现 最 后 这 个 
处 理 釉 ， 然 后 再 去 学 习 如 何 让 Web 程 序 提供 静态 文件 服务 。 


4.3 ”提供 静态 文件 服务 


很 多 Web 程 序 的 需求 即使 不 完全 相同 ， 也 是 相似 的 ， 而 静态 文件 (CSS、JavaScript、 图 片 ) 
服务 肯定 是 其 中 之 一 。 尽 管 写 一 个 健壮 而 又 高 将 的 静态 文件 服务 融 没什么 了 不 起 的 , 因为 在 Node 
社区 中 也 已 经 有 一 些 健壮 的 实现 了 ,但 跟着 本 市 的 介绍 做 一 个 日 己 的 静态 文件 服务 各 对 你 了 解 
Node 的 底层 文件 系统 API 很 有 帮助 。 

你 将 从 本 市 中 学 到 如 何 

口 创建 一 个 简单 的 静态 文件 服务 器 ; 

口 用 pipe () 优化 数据 传输 ; 

口 通过 设 定 状 态 码 处 理 用 户 和 文件 系统 错误 。 

我 们 先 从 创建 一 个 提供 静态 资源 服务 的 简单 HTTP 服 务 絮 开始 。 


4.3.1 创建 一 个 静态 文件 服务 器 


像 Apache 和 IIS 之 类 传统 的 HTTP 服 务 侣 首先 是 个 文件 服务 人 。 现 在 你 手 上 可 能 束 有 个 老 网 站 
跑 在 这 样 的 文件 服务 右上 ,把 它 移植 过 来 ,在 Node 上 复制 这 个 基本 功能 对 你 理解 过 去 所 用 的 HTTP 
服务 融 很 有 帮助 。 

每 个 静态 文件 服务 大 都 有 个 根 目录 , 也 就 是 提供 文件 服务 的 基础 目录 。 在 你 即将 要 创建 的 服 


























图 灵 社区 会 员 quqingtao 专 享 尊重 版 权 





74 第 4 章 ”构建 Node Web 程序 








务 册 上 将 会 定义 一 个 root 变 量 ， 它 将 作为 我 们 这 个 静态 文件 服务 邵 的 根 目录 : 


var http = require('http'); 


var Parse = regquire('url') .parse: 
Var Join = require('path') .join; 
Var fs = regquire('fs'); 

Var root = __ dirname,; 





dirname 在 Node 中 是 一 个 神奇 的 变量 ， 它 的 值 是 该 文件 所 在 目录 的 路 径 。_ airname 的 
神奇 之 处 就 在 于 ， 它 在 同一 个 程序 中 可 以 有 不 同 的 仁 ， 如 有 果 你 有 分 散在 不 同 目录 中 的 文件 的 话 。 
在 这 个 例子 中 , 服务 硕 会 将 这 个 脚本 所 在 的 目录 作为 静态 文件 的 根 目 录 , 但 实际 上 你 可 以 将 根 目 
录 配 置 为 任意 的 目录 路 径 。 

下 一 步 是 得 到 UREL 的 pathname ， 以 确定 被 请 求 文件 的 路 径 。 如 果 URL 的 pathname 是 
/index.html， 并 且 你 的 根 日 录 是 /Var/www/example.com/public， 用 path 模 块 的 .join() 方 法 把 
这 些 联接 起 来 就 能 得 到 绝对 路 径 Vwar/www/example.com/publicindex.html。 下 面 就 是 完成 这 些 操作 
的 代码 : 


var http = require('http'); 
































var Parse = regquire('url') .parse; 

var Join = regquire{'path') ,join; 

Var fs = regquire('fs'); 

var Yoot = dirname,; 

var Server = http.createSsServer (function (reg, res}t 
var Url = parse (redq.url); 
var Path = join{(root, url .pathname). 


小池 


server.listen(3000).， 


目录 遍历 攻击 
本 市 构建 的 文件 服务 器 是 个 简化 版 。 如 果 你 想 把 它 放 到 生产 环境 中 , 应 该 更 全 面 地 检查 输 
入 的 有 效 性 ， 以 防 用 户 通过 目录 遍历 攻击 访问 到 你 本 来 不 想 开放 给 他 们 的 那 部 分 内 容 。 维 基 百 
科 上 对 这 种 攻击 的 原理 做 了 解释 (http:/en.wikipedia.org/wikiDirectory traversal attack )。 





有 了 文件 的 路 径 还 需要 传输 文件 的 内 容 。 这 可 以 用 高 层 流 式 人 硬盘 访问 fs. ReadStream 完 
成 ， 它 是 Node 中 Stream 类 之 一 。 这 个 类 在 从 硬盘 中 该 取 文 件 的 过 程 中 会 发 射出 aata 事 件 。 下 面 
这 个 代码 清单 中 的 代码 实现 了 一 个 简单 但 功能 完备 的 文件 服务 硕 。 


代码 清单 4-3 ”最 基本 的 ReadStream 静 人 态 文 件 服务 疾 


var http = regquiret'http').; 





var parse = require('url') .parse; 
var Join = regquire{t'path') .JjJoin; 
var fs = require('fs').; 

var root = dirname; 
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Var server = http.createServer (function(req, res)t 
Var Url = parse (regq.uril); 构造 绝对 路 径 
var path = join(toot，uUrl.Pathname) ，; 
var stream = fs.createReadStream (path).; 二 一 一 一 一 创建 fs.ReadStream 
stream.on('data', function (chunk)t 
res.write(chunk) ; | 将 文件 数据 写 到 响应 中 
})3 
stream.on('end', function()t 
res.end(); < 一 文件 与 完 后 结束 响应 


}); 
J 


server.listen(3000).， 

这 个 文件 服务 硕大 体能 用 , 但 还 有 很 多 细 市 需要 考虑 。 接 下 来 我 们 要 优化 数据 的 传输 ， 同 时 
也 精简 一 下 服务 右 的 代码 。 

用 STREAM.PIPE() 优 化 数据 传输 

尺 管 了 解 fs .ReadSstream 的 工作 机 制 以 及 它 那 种 事件 方式 的 灵活 性 很 重要 ,但 Node 还 提供 
了 更 高 级 的 实现 机 制 : stream.pipe()。 用 这 个 方法 可 以 极 大 简化 服务 各 的 代码 。 




















管道 和 水 管 

把 Node 中 的 管道 想 旭 成 水 管 对 你 理解 这 个 概念 很 有 帮助 。 比 如 你 想 让 某 个 源头 (比如 热 
水 器 ) 流出 来 的 水 流 到 一 个 目的 地 ( 比如 厨房 的 水 龙头 )， 可 以 在 中 间 加 一 个 管道 把 它们 连 起 
来 ， 这 样 水 就 会 顺 着 管道 从 源头 流 到 目的 地 。 

Node 中 的 管道 也 是 这 样 ， 但 其 中 流动 的 不 是 水 ， 而 是 来 自 源 头 ( 即 ReadableStream ) 
的 数据 ， 管 道 可 以 让 它们 “流动 ”到 某 个 目的 地 ( 即 WritableStream )。 你 可 以 用 pipe 方 法 

ReadableSstream.pipe(WritableStream) ; 

读 取 一 个 文件 ( ReadableStream ) 并 把 其 中 的 内 容 写 到 另 一 个 文件 中 ( WritableStream ) 用 
的 就 是 管道 ， 

var readStream = fs.createReadStream('./original.txt') 

var writeStream = fs.createWriteStream('./copy.txt') 

readStream.pipe (writeStream).; 


所 有 ReadableStream 都 能 接 入 任何 一 个 WritableStream。 上 比如 HTTP 请 求 (req) 对 
银 就 是 ReadableStream， 你 可 以 让 其 中 的 内 容 流动 到 文件 中 . 


req.pipe(fs.createWriteStream('./req-body.txt')) 


要 深入 了 解 Node 中 的 数据 流 , 包括 它 内 置 的 各 种 数据 流 实现 , 请 参阅 Github 上 的 数据 流 手 
册 : https://github.com/substack/stream-handbook。 
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Var server = http.createServer (function(regq, res)t 
var url = parse (reqgq.url).; 
Var path = joinl(root, url.pathname).; 
var Stream = fs.createReadStream(path); res.end() 会 在 stream.pipe() 
stream.pipe (res); 内 部 调用 


了 让 
图 4-4 是 一 个 工作 中 的 HITP 服 务 硕 ， 它 从 文件 系统 中 旋 取 一 个 静态 文件 ， 并 用 pipe () 将 结 
采 传 到 HTTP 客 户 问 。 





服务 器 


GET / index.html 一 


Node 进 程 








a Var stream = fs.createReadStream(path).; 
stream.pipe (res); 
<——————— <html>...</html> 
fs.ReadStream 
Ci 有 人 请 求 服 务 器 上 的 文件 


@O Node 服 务 强 收 到 请 求 ， 你 的 


程序 逻辑 试 着 读 取 那个 文件 index htm 


文件 作为 Readstream 实 例 流 
动 到 服务 器 中 











名 文件 ReadSstream 通 过 管道 传 
到 HTTP 啊 应 中 完成 客户 端 
的 请 求 








图 4-4 一 个 用 fs .ReadStream 从 文件 系统 中 提供 静态 文件 的 Node HTTP 服务 需 


至 此 ， 你 可 以 用 下 面 的 cur1 命 令 来 测试 项 态 服务 需 是 否 能 正常 工作 。 选 项 -1 或 --incluae 
让 cURL 把 吗 应 头 输出 出 来 : 

$$ curil http://localhost:3000/static.js -i 

HTTP/1.1] 200 OK 


Connection: keep-alive 
Transfter-Encoding: chunked 








Var http = require('http'),; 
var parse = regquire('url') .parse,; 
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var Join = require{('path') .join; 





我 们 在 前 面 说 过 ， 这 里 的 根 目录 就 是 静态 文件 服务 带 脚 本 所 在 的 目录 ， 所 以 前 面 那 个 curl 
命令 请 求 的 就 是 服务 融 的 脚本 ， 它 被 当 作 啊 应 主体 送 回来 了 。 

这 个 静态 文件 服务 带 还 不 完整 , 因为 它 还 很 容 多 出错 。 一 个 未 处 理 的 寞 帝 ， 比 如 用 户 请 求 了 一 
个 不 存在 的 文件 ， 就 会 把 整个 服务 天 拖 垮 。 我 们 将 在 下 一 六 给 这 个 文件 服务 珍 加 上 错误 处 理 机 制 。 








4.3.2 ”处 理 服 务 器 错误 


我 们 的 静态 文件 服务 器 还 没有 处 理 因 使 用 fs .Readstream 可 能 出 现 的 错误 。 如 果 你 访问 不 
存在 的 文件 ， 或 者 不 允许 访问 的 文件 ， 或 者 碰 到 任何 与 文件 1O 有 关 的 问题 ， 当 前 的 服务 需 会 抛 
出 错误 。 我 们 将 在 本 节 中 介绍 如 何 证 文件 服务 硕 ， 或 其 他 任何 Node 服 务 硕 变 得 更 加 健壮 。 

在 Node 中 ， 所 有 继承 了 EventEmitter 的 类 都 可 能 会 发 出 error 事 件 。 像 fs .ReadStream 
这 样 的 流 只 是 专用 的 EventEmitter， 有 预 完 定义 的 data 和 end 等 事件， 我 们 已 经 看 过 了 。 默 认 
情况 下 ， 如 采 没 有 设置 监听 硕 ，error 事 件 会 被 抛 出 。 也 就 是 说 如 采 你 不 监听 这 些 错 误 ， 那 它们 
就 会 摘 垮 你 的 服务 釉 。 

为 了 说 明 这 个 问题 ,请 试 着 请 求 一 个 不 存在 的 文件 ， 比 如 /notfound.js。 在 终端 会 话 中 运行 服 
务 右 ， 你 会 看 到 在 stderr 中 输出 的 异常 的 堆栈 跟 踊 消 有 号 ， 像 下 面 这 样 : 


stream.jJs:99 
throw arguments [1]; // Unhandled 'error' event. 

















Error: ENOENT, No such file or directory 
'/Users/tj/projects/node-in-action/source/notfoungd.js' 


为 了 防止 服务 大 被 错误 摘 震 ， 我 们 要 监听 错误 ， 在 fs .ReadStream 上 注册 一 个 error 事 件 
处 理 右 ( 比如 下 面 这 段 代码 )， 返 回 啊 应 状态 码 500 表 明 有 服务 大 内 部 错误 : 


Stream.pipe TeS) 

stream.on{'error', function{err)}t 
res.statusCode = S500,， 
res.endl('Internal Server Error'). 


}); 











注册 一 个 errozr 事 件 处 理 胡 ， 可 以 捕获 任何 可 以 预见 或 无 法 预见 的 错误 ， 给 客户 端 更 优雅 
的 啊 应 。 


4.3.3 用 fs.stat() 实 现 先 发 制 人 的 错误 处 理 


因为 传输 的 文件 是 静态 的 ， 所 以 我 们 可 以 用 stat () 系统 调用 获取 文件 的 相关 信息 ， 比 如 修 
改 时 间 、 字 节 数 等 。 在 提供 条 件 式 Gar 支 持 时 ， 这 些 信息 特别 重要 ， 浏 览 器 可 以 发 起 请 求 检 查 它 
的 缓存 是 否 过 期 了 。 

重 构 后 的 文件 服务 器 如 代码 清单 4-4 所 示 , 其 中 调用 了 fs . stat () 用 于 得 到 文件 的 相关 信息 ， 
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比如 它 的 大 小 ， 或 者 得 到 错误 码 。 如 果 文 件 不 存在 ，fs .stat() 会 在 err.code 中 放 入 ENOENT 
作为 啊 应 ， 然 后 你 可 以 返回 错误 码 404， 回 客户 端 表 明文 件 未 找到 。 如 果 fs .stat () 返 回 了 其 他 
错误 码 ， 你 可 以 返回 通用 的 错误 码 500。 


代码 清单 4-4 ”检查 文件 是 否 存 在 ， 并 在 啊 应 中 提供 Content-Length 


Var server = http.createServer (function(req, res)t 








Var Url = parse (regq.uril); 解析 URL 以 获取 
-> var path = join(root, url.pathname); 路 径 名 
构造 绝对 fs.stat(path, functionl(err, stat)t{ 
路 径 在 ” 直 和 下 着 于 检查 文件 是 否 存 在 
一 > if ('ENOENT' == err.code) { 
res.statusCode = 404; 
文件 不 存在 ras. end (“Not Found "yy 
} else { ye 
res.statusCode = 500; | 其 他 错误 


res.end('Internal Server Error'); 
} 
} else { 
res.setHeader('Content-Length', stat.size).; 
Var stream = fs.createReadSstream (path)., 用 stat 对 象 的 属性 
stream.pipe (res); 
stream.on('error', functionl(err)t 
res.statusCode = 500;， 
res.end{'Internal Server Error').;: 
二 上 上 
L 
bi 
1); 


看 完 Node 的 的 层 文件 服务 , 接 下 来 我 们 去 看 一 个 同样 第 用 , 并 且 很 可 能 更 重要 的 Web 程 序 功 
能 : 从 HTML 表 单 中 取得 用 户 的 输入 。 


4.4 ”从 表单 中 接受 用 尸 输 入 


Web 程 序 通 常会 通过 表单 收集 用 户 的 输入 。Node 不 会 帮 你 承担 处 理工 作 (比如 验证 或 文件 上 
传 )， 它 只 能 把 请 求 主 体 数据 交 给 你 。 尽 管 这 看 起 来 不 太 方 便 ， 但 Node 一 贯 的 宗旨 是 提供 简单 高 
次 的 底层 API， 把 其 他 机 会 留 给 了 第 三 方 框架 。 

本 市 要 看 一 看 如 何 完 成 下 面 这 些 任 务 : 

口 处 理 提交 的 表单 域 ; 

口 用 formidable 处 理 上 传 的 文件 ; 

口 实时 计算 上 传 进度 。 

接 下 来 我 们 来 研究 一 下 如 何 用 Node 人 处 理 传 进来 的 表单 数据 。 


4.4.1 ”处 理 提交 的 表单 域 
表单 提交 请 求 市 的 content-Type 值 通 第 有 两 种 : 


设置 Content-Length 
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口 application/x-www-form-urlencoded: 这 是 HTML 表 单 的 默认 值 ; 

口 multipart/form-data: 在 表单 中 含有 文件 或 非 ASCII 或 二 进 制 数据 时 使 用 。 

本 闻 会 重 与 前 面 那个 待 办 事项 程序 , 这 次 要 用 表单 和 浏览 带 。 做 完 后 , 你 会 得 到 一 个 像 图 4-5 
那样 的 Web 竺 办 事项 列表 。 








€© 3》 CC © localhost:3000 各 人 名 © localhost:3000 








To-do List To-do List 


es foo 
。 bar 
se baz 





(Add ltem ) 





Add item ) 











图 4-5 ”使 用 表单 和 训 览 融 的 待 办 事项 程序 。 在 两 张 规 屏 中 ,， 左 侧 的 是 程序 第 一 次 加 载 
时 的 状态 ， 右 侧 的 是 添加 了 一 些 事项 之 后 的 样子 








在 这 个 竺 办 事项 列表 程序 中 , 对 请 求 方法 red.method 用 了 一 个 switch， 以 实现 简单 的 请 求 
路 由 。 具体 做 法 如 代码 清单 4-5 所 示 。 所 有 不 是 "" 的 URL 都 会 得 到 404 Not Found 响 应 。 所 有 非 GET 
或 PosT 的 HTTP 谓 词 请 求 都 会 得 到 400 Bad Request 啊 应 。 本 节 后 续 内 容 会 通 篇 介绍 处 理 带 函数 
show() 、add() 、badRequest () 的 实现 。 





代码 清单 4-5 “支持 GET 和 POST 的 HTTP 服 务 器 


var http = require('http'); 
var items = []; 


http.createServer (functionl(reg, res})t 





Var Server = 
I {A UL}) 1 
switch (reaq.method) f{ 
CASS GED': 
SNow(res): 
break; 
CasSe ‘POST': 
add {req, res); 
break,; 
default: 
badRequest (res); 





} 
} else 1 
notFound {res},. 
} 
i 


Server.listen(3000),， 

尽管 一 般 都 用 模板 引擎 生成 HTML 标 记 , 但 为 了 简单 起 见 ， 下面 这 个 清单 用 的 还 是 拼接 字符 
串 的 办 法 。 因 为 默认 的 啊 应 状态 就 是 200 OK， 所 以 这 里 没 必要 给 res .statusCcode 赋 值 。 最 终 
在 浏览 器 中 的 HTML 页 面 如 图 4-5 所 示 。 
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代码 清单 4-6” 符 办 事项 列表 页 面 的 表单 和 事项 列表 


function show(res) { 


var html = '<html><head><title>Todo List</title></head><body>' 
+ '<h1i>Todo List</h1l>' 
el 对 简单 的 程序 而 言 ， 用 绊 入 的 
+ ltems.map (function(item)t HTML 取 代 模 板 引 擎 一样 好 用 


return '<li>' + item + '</1i>' 
OL 

+ '</ul>' 

+ !<form method="post" action="/">! 

+ ‘<p><input type="text" name="item" /></pP>:! 

+ '<pP><input type='"'submit'" value='"Add Item'" /></pP>'! 

+ '</form></body></html>';: 
res.setHeader{'Content-Type’', ‘text/htm) ')}); 
res.setHeader{'‘Content-Length’:, Buffer.byteLength (htm]j))}:; 
res.end {html).; 





} 
notFound () 子 数 接收 啊 应 对 象 ， 将 状态 公设 为 404， 啊 应 主体 设 为 Not Found: 


function notFound{res) f 
res.statusCode = 404: 
res.setHeader!{('Content-Type', 'text/plain'); 











res.end{'Not Found'}); 


} 
返回 400 Bad Request 呵 应 的 函数 实现 起 来 跟 notFound() 几乎 一 样 , 回 客户 端 指 明 该 请 求 无 效 ; 


function pacRedcuestL res) { 
res.statusCode = 400 1 
res.setHeader''Content-Type', 'text/plain').; 
res.end{'Bad Reguest').; 








} 
程序 最 后 还 要 实现 add() 因数 ， 它 会 接收 req 和 tres 两 个 对 象 。 代 人 码 如 下 所 示 : 


var qs = require('querystring').; 











function add(req, res) { 


Var body = '';， 

req.setEncoding('utf8').,; 

req.on('data', function(chunk}{ body += chunk }); 
redq.on('end', functiont()t 


var obj = gqs.parse (body); 
items .push (obj.item).; 
show (res).; 
J 
} 


为 了 简单 起 见 这 个 例子 假定 Content-Tvype 是 app1 ijcation/x-www-form-urlencoded, 
这 也 是 HTML 表 单 的 默认 值 。 要 解析 数据 , 只 需 把 data 事 件 的 数据 块 拼接 到 一 起 形成 完整 的 请 求 
主体 字符 串 。 因 为 不 用 处 理 二 进 制 数据 ， 所 以 可 以 用 res .setEncoding () 将 请 求 编 码 类 型 设 为 
utf8。 在 请 求 发 出 snq 事 件 后 , 所 有 data 事 件 就 完成 了 , 整个 请 求 体 也 会 变 成 字符 串 出 现在 bodqy 


2 
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缓冲 太 多 数据 
对 于 包含 一 点 JSON、XML 或 类 似 小 块 数 据 的 请 求 主体 ， 缓 冲 很 好 用 ， 但 缓冲 这 个 数据 可 
能 会 有 问题 。 如 果 缓 冲 区 的 大 小 设置 不 正确 , 很 可 能 会 让 程序 出 现 可 用 性 漏洞 ， 这 个 我 们 在 第 
7 和 章 再 展开 讨论 。 因 此 ， 比 较 好 的 作法 是 实现 一 个 流 式 解析 器 ， 降 低 对 内 存 的 要 求 ， 防 止 过 度 
消耗 资源 。 尽 管 更 难 使 用 和 实现 ， 但 这 个 处 理会 随 着 数据 块 的 不 断 发 出 做 增 量 式 解 析 。 


QUERYSTRING 模 块 
在 aqa() 函数 中 解析 请 求 主体 时 , 用 到 了 Node 的 querystring 模 块 。 来 看 看 在 REPL 中 的 快速 演 





示 ， 了 解 下 Node 服 务 需 中 用 到 的 这 个 auerystring.parse() 图 数 是 如 何 解 析 请 求 主 体 的 。 
假设 用 户 通过 HTML 表 单 向 待 办 事项 列表 中 提交 了 文本 “take ferrets to the vet”: 
S node 
> Var gqs = regquire{(l'guerystring').; 
> Var body = 'item=take+ferrets+torthervet'.; 





> ds.parse {body).; 
{ item: 'take ferrets to the vet' } 


在 添加 完事 项 之 后 ， 服 务 器 调用 前 面 实现 的 那个 show () 本 数 把 用 户 又 市 回 了 原来 那个 表单 
页 。 这 只 是 这 个 例子 选择 的 路 由 ， 你 可 以 选择 显示 一 条 “事项 已 添加 到 竺 办 事项 列表 中 ”消息 的 
页 面 ， 或 者 回 到 /页 面 。 

试 一 下 吧 。 添 加 几 个 事项 ， 你 会 看 到 竺 办 事项 出 现在 一 个 未 经 排序 的 列表 中 。 你 还 可 以 实现 
前 面 在 REST API 中 实现 的 删除 功能 。 








4.4.2 ”用 formidable 处 理 上 传 的 文件 


在 Web 开 发 中 ,文件 上 传 也 是 一 个 非常 常见 、 非 常 重要 的 功能 。 想 象 一 下 ， 你 正 要 创建 一 个 
可 以 上 传 相册 的 程序 ， 还 要 通过 Web 链 接 跟 其 他 人 分 享 你 的 照片 。 借 助 带 文件 上 传 控件 的 表单 ， 
用 训 览 可 可 以 实现 这 个 功能 。 

下 面 这 个 例子 给 出 了 一 个 可 以 上 传 文件 的 表单 ， 里 面 还 有 一 个 与 文件 相关 联 的 name 域 : 

<form method="post" action="/" enctype="multipart/form-data"> 

<p><input type="text" name='"name'" /></p> 

<p><input type="ftile" name="file'" /></p> 


<p><input type="submit" value="Upload" /></p> 
</ form> 


要 正确 处 理 上 传 的 文件 ， 并 接收 到 文件 的 内 容 ， 需 要 把 表单 的 enctype 属 性 设 为 
multipart/form-data， 这 是 个 适用 于 BLOB (大 型 二 进 制 文件 ) 的 MIME 类 型 。 

以 高 效 流畅 的 方式 解析 文件 上 传 请 求 并 不 是 个 简 简 单单 的 任务 , 我们 不 会 在 本 书 中 讨论 其 中 
的 细 方 。Node 社 区 中 有 几 个 可 以 完成 这 项 任务 的 模块 。formidable 就 是 其 中 之 一 ， 它 是 由 Felix 
Geisend6rfer 为 自己 的 创业 公司 Transloadit 创 建 的 ， 用 于 媒体 上 传 和 转换 ， 性 能 和 可 靠 性 很 关键 。 

formidable 的 流 式 解 析 融 让 它 成 为 了 处 理 文件 上 传 的 绝 佳 选择 ， 也 就 是 说 它 能 随 看 数据 块 的 
上 上 传 接 收 它 们 ,解析 它 们 ， 并 吐出 特定 的 部 分 ， 就 像 我 们 之 前 提 到 的 部 分 请 求 头 和 请 求 主体 。 这 
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种 方式 不 仅 快 ,还 不 会 因为 需要 大 量 缓冲 而 导致 内 存 膨胀 ,即便 像 视 频 这 种 大 型 文件 ， 也 不 会 把 
进程 压 震 。 

现在 回 到 我 们 照片 分 享 的 例子 上 。 下 面 这 个 清单 中 的 HTTP 服 务 絮 实现 了 文件 上 传 服务 絮 的 
起 始 部 分 。 它 用 HTML 表 单 响 应 ET 请求， 还 有 一 个 处 理 PosT 请 求 的 空 函数 ,我 们 会 在 这 个 函数 
中 集成 formidable 来 处 理 文件 上 传 。 


代码 清单 4-7 ”准备 好 接收 上 传 文件 的 HITP 服 务 需 


var http = require('http').; 





Var server = http.createServer (function{regq, res)t 
switch (req.method) { 
Case ‘GET': 
show (redq, res).; 
break; 


CASE 'POST': 
upload(lreq, res).; 


break.; 
} 
2 提供 带 有 文件 上 传 
function show(regq, res) ({ 控件 的 HTML 表 单 


var html = '' 
+ '<form method="post" action="/" enctype="multipart/form-data">' 
+ '<p><input type="text" name='"name'" /></p>' 
+ '<p><input type="file" name="file" /></p>'! 
+ '<p><input type="submit" wvalue="Upload" /></pP>' 
+ '</form>',; 
res.setHeader('Content-Type', 'text/html')}):; 
res.setHeader ({'Content-Length', Buffer.byteLength{(html)):; 
res.endlhtml)}),; 





function uploadl(req, res) f{ 
// 上 传 远 辑 
} 


料理 好 GET 请 求 ， 该 实现 upload() 限 数 了 。 当 有 POST 请 求 进来 时 ， 会 调用 这 个 回调 也 数 。 
upload () 函数 需要 接收 传人 的 上 传 数据 , 我 们 把 这 个 交 给 formidable 处 理 。 本 市 后 绪 内 容 会 介绍 
集成 formidable 需 要 完成 哪些 工作 : 

(1) 通过 npm 安 疾 formidable; 

(2) 创建 一 个 IncomingForm 实 例 ; 

(3) 调用 form.parse() 解析 HTTP 请 求 对 和 象 : 

(4) 监听 表单 事件 fielda、file 和 end; 

(5) 使 用 formidable 的 高 层 API。 

要 在 项 目 中 使 用 formidable， 第 一 步 就 是 安装 它 。 运 行 下 面 这 条 命令 就 可 以 了 ， 它 会 把 这 个 
模块 狼 到 项 目 内 的 ./node_modules 目 录 下 : 


$s npm install formidable 
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要 使 用 它 的 API， 需 要 require() 它 ， 还 有 最 开始 那个 http 模 块 . 


var http = require('http')}).; 
var formidable = require('formidable'): 


实现 upload() 困 数 ， 首 先是 在 请 求 中 的 内 容 类 型 不 对 时 返回 400 Bad Request 吧 应 : 
function upload(req, res) { 
if {IisFormData{regq)}) { 
res.statusCode = 400; 


res.endt{'Bad Request: expecting multipart/form-data'): 
returis 








} 





function isFormData(rea}) { 
var type = req.headers{['content-type'] || ; 


return 0 == type.indexOf {multipart/form-data'}; 
} 


辅助 国 数 1sFormData ( ) 用 string .lndexOf () 方法 含 查 请 求 头 中 的 Content-Type 字 段 ， 
其 言 它 的 值 是 以 multipart/form-dqata 开 头 的 。 

在 你 确定 了 这 是 一 个 文件 上 传 请 求 后 ， 需 要 初始 化 一 个 新 的 formiadable. IncomingForm 
表单 ， 然 后 调用 form.parse (req) 方 法 ， 其 中 的 regq 是 请 求 对 象 。 这 样 formidable 就 可 以 访问 请 
求 的 data 事 件 进行 解析 了 : 


function upload (req, res) { 
if {IisFormData{regq)}) { 
res.statusCode = 400; 
res.end{'Bad RecuesSt '  ) ; 
return; 














} 


Var form = new formidable.IncomingForm!{(}; 
form.parse (req).; 


} 

IncomingForm 对 象 本 壬 会 发 出 很 多 事件 , 默认 情况 下 , 它 会 把 上 传 的 文件 流入 /tmp 目 录 下 。 
如 下 所 示 ， 在 处 理 完 表单 元 到 后 ，formidable 会 发 出 事件 。 比 如 说 ， 在 收 到 文件 并 处理 好 后 会 发 
出 file 事 件 ， 收 完 输入 域 后 会 发 出 fielg 事 件 。 


代码 清单 4-8 使 用 formidable API 








var form = new formidable.IncomingForm!():; 


form.on{({'field', function{({field, wvalue)}t 
console.logl{field)}); 
console.log(value): 


}); 


form.on{({'file', function(name, file}t 
console.1log (name}); 
console.log {file)}).; 


}); 
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form.on{'end', function(})tf 
res.end{({'upload completel!'); 


}); 


form.parse (regq): 





通过 查看 Eiel1dq 事 件 处 理 硕 中 对 console.1og() 的 两 次 调用 ， 你 能 看 到 用 户 在 文本 域 name 
中 输入 了 “my clock”: 


name 
my clock 


文件 上 传 完 成 后 发 出 了 file 事 件 。file 对 象 为 你 提供 了 文件 大 小 ,在 form.uploaqDir 目 录 (默认 
为 hmp ) 中 的 路 径 ， 原 始 的 主 档 名 ， 以 及 MIME 类 型 。 当 传 到 console.1og() 中 时 ，file 对 和 象 如 下 所 示 : 


{ size: 28638, 
path: '/tmp/d870ede4d015s507a68427a3364204cdf3',， 
name: 'clock.png', 
type: 'image/png’', 
lastModifiedDate: Sun, 05 Jun 2011 02:32:10 GMT, 
liength: [Getter], 
fijlename: [Getterl], 
mime: [Getter], 
8 a 
Formidable 还 提供 了 比较 高 级 的 API, 基本 上 就 是 把 我 们 刚才 看 到 的 儿 个 API 封 淡 到 一 个 回调 
呆 数 中 。 当 把 一 个 函数 传人 到 form.parse() 中 时 ， 第 一 个 参数 是 为 可 能 发 生 的 错误 准备 的 
error。 如 果 没 有 错误 ， 就 会 传人 和 后面 的 两 个 对 象 : fields 和 files。 
fields 对 象 看 起 来 就 像 console.1og() 的 下 面 这 种 输出 : 
{ name: my clock' } 
files 对 象 跟 file 事 件 中 的 File 实 例 一 样 ， 像 fijelgds 那 样 以 名 称 为 键 。 
一 定 要 注意 , 使 用 这 个 回调 并 不 会 影响 你 监听 这 些 事件 , 所 以 像 进度 报告 这 样 的 功能 也 不 会 
受到 妨碍 。 下 面 这 段 代码 展示 了 如 何 使 用 这 个 更 精简 的 API 得 到 我 们 前 面 已 经 讨论 过 的 结 


var form = new formidable.IncomingForm!(); 

















form.parse (regq, function(err, fields, files}t 





console.log(fields).: 





console.log(files),; 
res.end{({'upload comolete!'). 


上 
基础 功能 已 经 实现 了 , 接 下 来 我 们 会 看 看 如 何 计算 上 传 进度 , 这 对 Node 和 它 的 事件 循环 来 说 
是 个 非常 目 然 的 处 理 。 


4.4.3 ”计算 上 传 进度 


Formidable 的 progress 事 件 能 给 出 收 到 的 字 节 数 ， 以 及 期 望 收 到 的 字 节 数 。 我 们 可 以 借助 
这 个 做 出 一 个 进度 条 。 在 下 面 这 个 例子 中 ， 每 次 有 progress 事 件 激发 ， 就 会 计算 百分比 并 用 
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console.1log() 输 出 : 


form.on( 'progress', function(bytesReceived, bytesExpected)t 
var Percent = Math.fljoor(lbytesReceived / bytesExpected * 100) ， 








console.1log{lpercent).; 


a 
es 


这 段 脚 本 会 产生 下 面 这 种 输出 : 


CC mi a 


99 

100 

你 已 经 了 解 这 个 概念 了 , 很 明显 我 们 接 下 来 要 把 这 个 进度 传 回 到 用 户 的 浏览 各 中 去 。 这 对 于 
任何 想 要 上 传 大 型 文件 的 程序 来 说 都 是 个 很 棒 的 特性 , 并 且 这 是 个 很 适合 用 Node 完 成 的 任务 。 比 
如 说 用 WebSocket 协 议 ， 或 者 像 SocketIJO 这 样 的 实时 模块 ， 可 能 只 需要 几 行 代码 。 我 们 把 这 个 留 
给 你 当 作 练习 了 。 

还 有 最 后 一 个 主题 ， 并 且 是 个 非常 重要 的 主题 : 程序 的 安全 性 。 


4.5 用 HTTPS 加 强 程 序 的 安全 性 


对 于 电子 商务 网 站 , 以 及 那些 会 涉及 到 敏感 数据 的 网 站 来 说 ,一般 都 要 求 能 够 保证 跟 服 务 央 
往来 的 数据 是 私密 的 。 在 标准 的 HITTP 会 话 中 ， 客 户 端 跟 服务 亏 端 用 未 经 加 密 的 文本 交换 信息 。 
这 使 得 HTTP 通 信 很 容易 被 鳃 听 。 

安全 的 超 文 本 传输 协议 (HTTPS ) 提供 了 一 种 保证 Web 会 话 私密 性 的 方法 。HTTPS 将 HTTP 
和 TLS/SSL 传 输 层 结合 到 一 起 。 用 HTTPS 发 送 的 数据 是 经 过 加 密 的 ， 因 此 更 难 镭 听 。 本 市 会 介绍 
一 些 用 HTTPS 加 强 程序 安全 性 的 基础 知识 。 

如 果 你 想 在 你 的 Node 程 序 里 使 用 HTTPS， 第 一 件 事 就 是 取得 一 个 私 钥 和 一 份 证 书 。 私 钥 本 
质 上 是 个 “ 秘 钥 ” ， 可 以 用 它 来 解密 客户 端 发 给 服务 需 的 数据 。 私 钥 保 存在 服务 需 上 的 一 个 文件 
里 ， 放 在 一 个 不 可 信用 户 无 法 轻易 访问 到 的 地 方 。 本 贡 会 教 你 如 何 生成 一 个 上 自 签 发 的 证 书 。 这 种 
SSL 证 书 不 能 用 在 正式 网 站 上 ， 因 为 当 用 户 访问 党 有 不 可 信 证 书 的 页 面 时 ,浏览 硕 会 显示 警告 信 
息 ， 但 对 于 开发 和 测试 经 过 加 密 的 通信 而 言 ， 它 很 实用 。 

生成 私 钥 需 要 OpenSSL, 在 装 Node 时 就 已 经 装 过 了 。 打开 命 令 行 窗口 , 输入 下 面 的 命令 会 生 
成 一 个 名 为 key.pem 的 私 钥 文件 : 

openssl genrsa 1024 > key .pem 

除了 私 钥 ， 你 还 需要 一 份 证 书 。 证 书 跟 私 钥 不 同 ， 可 以 与 全 世界 分 享 ， 它 包含 了 公 钥 和 证 书 

寺 有 者 的 信息 。 公 和 钥 用 来 加 密 从 客户 端 发 往 服务 妖 的 数据 。 
创建 证 书 需 要 私 钥 。 输 入 下 面 的 命令 会 生成 名 为 key-cert.pem 的 证 书 : 
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openssl red -X509 -new -Key key.pem > key-~-cert.pem 

秘 钥 已 经 生成 了 ,把 它们 放 到 一 个 安全 的 地 方 。 在 下 面 的 代码 清单 中 ,我 们 引用 的 秘 钥 跟 服 
务 骨 脚本 放 在 同一 个 目录 下 ， 但 秘 钥 通 币 都 是 放 在 别处 ， 一 般 是 ~/.ssh。 下 面 的 代码 会 创建 一 个 
使 用 秘 钥 的 HTTPS 服 务 器 。 


代码 清单 4-9 HTTPS 服 务 器 配置 项 


var https = require('https'); 











var fs = regquire('fs'); 
var options = 1 | 作为 配置 项 的 SSL 秘 钥 和 证 书 
key: fs.readFileSync('./key.pem'), 
cert: fs.readFileSync('./key-cert.pem') 
> A 
第 一 个 传 入 的 就 是 配 
https.createServer (options, function (req, res) { 置 项 对 象 
iteHead(200); 
res.writeHeadl ) https 和 http 模 
res.end("hello world\n"); 块 的 API| 几 乎 一 样 
}) .listen(3000); 


HTTPS 服 务 硕 的 代码 跑 起 来 后 , 就 可 以 用 浏览 各 跟 它 建立 安全 的 连接 了 。 你 只 需 在 浏览 带 中 
访问 https://localhost:3000/。 因 为 我 们 这 个 例子 中 所 用 的 证 书 不 是 由 证 书 颁 发 机 构 颁 发 的 ， 所 以 会 
显示 一 个 警告 信息 。 这 里 可 以 忽略 这 个 警告 , 但 如 果 要 把 网 站 部 署 到 公 网 上 ， 你 就 应 该 找 个 证 书 
颁发 机 构 ( CA ) 进行 注册 ， 并 为 你 的 服务 需 取 得 一 份 真实 的 、 受 信 的 证 书 。 








4.6 小结 


本 章 介 绍 了 Node 中 HTTP 服 务 顺 的 基础 知识 ， 辐 你 展示 了 如 何 啊 应 请 求 ， 以 及 如 何 处 理 异 步 
异常 以 保证 程序 的 可 靠 性 。 你 还 学 会 了 如 何 创 建 RESTful 的 Web 程 序 ， 提 供 静 态 文件 访问 ， 甚 至 
创建 一 个 上 传 进度 计算 需 。 

你 可 能 也 看 出 来 了 ， 从 Web 程 序 开发 人 员 的 角度 来 看 , 用 Node 起 步 比 较 困 难 。 但 作为 经 验 丰 
富 的 Web 开 发 人 员 , 我 们 向 你 保证 你 的 付出 是 值得 的 。 这 些 知识 能 帮 你 加 深 对 Node 的 理解 ， 对 你 
调试 、 编 写 开 源 框 桨 、 或 为 已 有 框架 做 贡献 都 很 有 帮助 。 

本 董 的 基础 知识 是 为 你 深 入 学 习 Connect 做 的 准备 ，Connect 是 一 个 很 棒 的 高 级 框架 ， 提供 了 
一 僚 所 有 Web 程 序 框架 都 能 用 到 的 功能 组 件 。 接 着 是 Express， 更 是 锦上添花 ! 这 些 工 具 放 到 一 起 
能 让 你 在 本 草 学 到 的 这 些 东 西 变 得 更 容易 ， 更 安全 ， 并 且 更 有 趣 。 
































建 的 大 量 数据 库 客 户 端 ， 以 便 用 它们 加 强 你 在 本 书 剩余 部 分 创建 的 程序 。 
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存储 Node 程 序 中 的 数据 


本 章 内 容 

口 内 存 和 文件 系统 数据 存储 
口 传统 的 关系 型 数据 库存 储 
口 非 关 系 型 数据 库存 储 





几乎 所 有 的 程序 , 不 管 是 不 是 基于 Web 的 ,都 需要 某 种 类 型 的 数据 存储 机 制 , 用 Node 构 建 的 
程序 也 不 例外 。 选 择 合适 的 存储 机 制 取决 于 以 下 五 个 因素 : 

D 存储 什么 数据 ; 

口 为 了 保证 性 能 ， 要 有 多 快 的 数据 谈 取 和 写 人 速度 ; 

口 有 多 少数 据 ; 

口 要 怎么 查询 数据 ; 

口 数据 要 保存 多 久 ， 对 可 靠 性 有 什么 要 求 。 

存储 数据 的 方法 很 多 ， 从 放 在 服务 大 内存 中 到 连接 一 个 完备 的 数据 库 管 理 系统 (DBMS ) 不 
一 而 足 ， 但 所 有 的 方法 都 有 利 有 网 。 

有 些 机 制 文 持 结构 复杂 的 数据 的 长 期 持久 化 , 并 且 有 强大 的 搜索 功能 , 但 要 承担 昂贵 的 性 能 
成 本 ,所 以 有 时 并 不 是 最 好 的 选择 。 同 样 ， 把 数据 放 在 服务 絮 内 存 中 能 得 到 最 好 的 性 能 , 但 可 徘 
性 不 强 ， 如 采 程 序 重 局 ， 或 服务 着 断 电 ， 数 据 就 会 丢失 。 

所 以 怎么 为 程序 选择 恰当 的 存储 机 制 ? 在 Node 程 序 开 发 的 世界 中 ,经 常会 为 不 同 的 应 用 场景 
使 用 不 同 的 存储 机 制 。 本 章 会 讨论 三 种 不 同 的 选择 : 

D 存储 数据 而 无 需 安 闻 和 配置 DBMS ; 

口 用 关系 型 数据 库存 储 数据 ， 具 体 说 就 是 MySQL 和 PostgreSQL; 

口 用 NoSQL 数 据 库存 储 数据 ， 具 体 说 就 是 Redis、MongoDB 和 Mongoose。 

在 本 书后 续 章 市 中 ,你 构建 的 程序 将 会 用 到 其 中 的 一 些 机 制 , 并 且 看 完 本 半 后 ,你 会 知道 如 
何 用 这 些 存储 机 制 满 足 程序 的 需求 。 作 为 开始 ,我 们 先 来 看 最 简单 、 最 低级 的 存储 方式 : 无 服务 
谷 的 数据 存储 。 
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5.1 无 服务 器 的 数据 存储 


从 系统 管理 的 角度 来 看 ， 最 方便 的 存储 机 制 是 那些 不 用 维护 DBMS 的 存储 ， 比 如 内 存 存储 和 
基于 文件 的 存储 。 因 为 不 用 安装 和 配置 DBMS ， 所 以 程序 安装 起 来 也 更 容易 。 

有 时 ， 缺 少 DBMS 的 文 持 ， 使 得 无 服务 需 的 数据 存储 成 了 完美 的 选择 。 尤 其 是 对 于 那些 运行 
在 目 己 服务 需 上 的 Node 程 序 来 说 ， 比 如 Web 程 序 和 其 他 TCP/P 程 序 。 它 还 特别 适合 命令 行 界 面 
(CLI) 工具 : Node 驱 动 的 CLI 工 具 很 可 能 要 存储 数据 ， 但 用 户 不 太 可 能 为 了 用 这 个 工具 而 再 去 大 
费 周章 地 搭 一 个 MySQL 服 务 右 。 

本 节 将 会 介绍 何 时 以 及 如 何 使 用 内 存 存储 和 基于 文件 的 存储 , 这 两 个 是 无 服务 器 数据 存储 的 
主要 形式 。 我 们 先 从 最 简单 的 开始 : 内 存 存储 。 


5.1.1 内 存 存储 


在 第 2 草 和 第 4 章 的 例子 中 ,内 存 存储 被 用 来 跟踪 记录 与 聊天 用 户 和 任务 相关 的 详细 信息 。 内 
存 存储 用 变量 存放 数据 。 这 种 数据 的 读 取 和 写 入 都 很 快 , 但 就 像 我 们 在 前 面 提 过 的 ， 服务 右 和 程 
序 重 局 后 数据 就 丢 了 。 

内 存 存储 的 理想 用 途 是 存放 少量 经 常 使 用 的 数据 。 用 来 跟踪 记录 最 近 一 次 重 局 服务 珊 后 页 面 
访问 次 数 的 计数 硕 就 是 这 样 的 应 用 场景 。 比 如 下 面 这 段 代 码 ， 它 在 8888 放 口 司 动 了 一 个 服务 融 ， 
并 对 所 有 请 求 进行 计数 : 

Var http = require('http'); 

Var Counter = 0; 



































Var server = http.createServer (functionl(reg, res) { 





COUT 七 全 工 二 十， 
res.write('I have been accessed ' + counter + ' times.'}); 
res.end!(),; 

}) .listen(8888),; 


对 于 知 要 把 信息 存 起 来 ,在 程序 和 服务 带 重 局 后 能 持久 化 的 程序 ,基于 文件 的 存储 可 能 更 合适 。 


5.1.2 ”基于 文件 的 存储 


基于 文件 的 存储 ,用 文件 系统 存放 数据 。 开 发 人 员 经 第 用 这 种 存储 方式 保存 程序 的 配置 信息 ， 
但 你 也 可 以 用 它 做 数据 的 持久 化 保存 ， 这 些 数据 在 程序 和 服务 占 重 局 后 依然 有 效 。 





并 发 问题 
基于 文件 的 存储 虽然 田 用 , 但 并 不 是 所 有 程序 都 适合 。 比 如 说 , 一 个 多 用 户 程序 如 果 把 记 
录 保 存在 一 个 文件 中 ， 可 能 会 碰 到 并 发 问题 。 两 个 用 户 可 能 会 同时 加 载 相 同 的 文件 进行 修改 。 
保存 一 个 版 本 会 履 盖 另外 一 个 ， 导 致 其 中 某 个 用 户 的 修改 丢失 。 对 于 多 用 户 程序 而 言 ， 数 据 库 
管理 系统 是 更 合理 的 选择 ， 因 为 它们 就 是 为 应 对 并 发 问题 而 生 的 。 
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为 了 阐明 如 何 使 用 基于 文件 的 存储 方式 ， 我 们 给 第 4 章 那个 基于 Web 的 竺 办 事项 程序 创建 一 
个 简单 的 命令 行 版 本 。 图 $-1 是 使 用 这 个 版 本 时 的 截图 。 
个 程序 会 把 任务 存 到 文件 .tasks 中 ， 跟 运行 的 脚本 在 同一 目录 下 。 在 保存 之 前 ， 任 务 会 被 
转换 成 JSON 格 式 ， 从 文件 中 旋 出 来 时 再 从 JSON 格 式 转 回来 。 
创建 这 个 程序 需要 编写 启动 逻辑 ， 并 定义 获取 及 存储 任务 的 辅助 子 数 。 


HMMA 1. Shell 一 








$ node clLi_tasks.js add Floss the cat. 
Saved. 

$ node cli_tasks.]js list 

Floss the cat. 

$ node cli_tasks.]js add Buy some hats. 


Saved. 

$ node clLi_tasks.js list 
Floss the cat. 

Buy some hats. 

$s 





图 5-1 命令 行 版 的 待 办 事项 列表 工具 


1. 编写 局 动 逻 辑 
文 段 逻辑 从 引入 必需 的 模块 开始 ,然后 解析 来 自命 令 行 参 数 的 任务 命令 和 描述 , 并 指明 用 来 
保存 任务 的 文件 。 代 码 如 下 所 示 。 


代码 清单 5-1 ”收集 参数 值 并 解析 文件 数据 库 的 路 径 











var fs = require('fs'); 
var ath = requirel path'y); 去 掉 “node cli_tasks.js”， 
Var args = process.argv.splice(2); 只 留 下 参数 
var command = args.shift().; 
四 | ”| 取出 第 一 个 参数 命令 ) 
var taskDescription = args.Join(' ');，; 
合并 剩余 的 
| ma | jj、 . , ' 
放 Var file = path.join(process.cwd(), '/.tasks'); a 
参数 根据 当前 的 工作 目录 解 
析 数 据 库 的 相对 路 径 








如 果 你 提供 了 动作 参数 ,程序 或 者 输出 已 保存 任务 的 列表 ,或 者 添加 任务 描述 到 任务 存储 中 ， 
代码 如 下 所 示 。 如 果 没 提供 参数 ， 则 会 显示 用 法 帮助 。 


代码 清单 5-2 确定 CLI 脚 本 应 该 采取 什么 动作 
switch (command) { 
case 'list': 
listTasks (file)', 下 '1List' 会 列 出 所 有 已 保存 的 任务 
break; 


Case 'add': ee 
addTask (file, taskDesocription); ”| 'aaa' 会 添加 新 任务 
break; 
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default: 
console.log('Usage: ' + process.argv[0] | 其 他 任何 参数 都 会 显示 帮助 
+ ' listl|add [taskDescription]'); 


} 
2. 定义 获取 任务 的 辅助 函数 
接 下 来 要 在 程序 逻辑 中 和 定义 一 个 辅助 图 数 ，1oadqorInitializeTaskArzav， 用 来 获取 已 


有 的 任务 。 如 代码 清单 5-3 所 示 ， 0 会 从 一 个 文本 文件 中 加 载 编 码 


为 JSON 格 式 的 数据 。 代 码 中 用 到 了 fs 模块 中 的 两 个 异步 函数 。 这 些 孔 数 是 非 阻 窒 的 , 事件 轮 询 可 
以 继续 ， 无 需 坐等 文件 系统 返回 结 

















代码 清单 5-3 ”从 文本 文件 中 加 载 用 JISON 编 码 的 数据 


function loadOorIinitializeTaskArray (file, cb) { 


检查 .tasks 文 件 是 否 已 
res.arioteslftile, Function(erxietes) 1 经 存在 
Var tasks = [|]; 
if (exists) { 从 .tasks 文 件 中 读 取 待 办 
fs .readrile(file, ES fnotion(err, aata) 4 事项 数据 
if (err) throw err; 
Var data = data. tootreing(}; 把 用 JSON 编 码 的 待 办 事项 
Var tasks = JSON.parse(data || '[]'); 数据 解析 a 到 任务 数组 中 
cb(tasks); 
1: 
} LE | 如 果 .tasks 文 件 不 存在 ， 
ee | 则 创建 空 的 任务 数组 


} 
}); 
} 


接 下 来 用 辅助 函数 loadorInitiali zeTaskArray 实 现 1 istTasks 功 能 。 
代码 清单 5-4 列 出 任务 的 吨 数 


function listTasks (file) 1{ 
loadOorIinitializeTaskArray (file 
forlvar 1 in tasks) f{ 
console.log{({tasks[i]): 





， function(tasks) { 


} 
J 
} 


3. 定义 一 个 存放 任务 的 辅助 函数 
现在 定义 另 一 个 辅助 图 数 ，storeTasks， 把 任务 用 JSON 串 行 化 后 放 到 文件 中 。 
代码 清单 5-5 ”把 任务 保存 到 磁盘 中 


function storeTasks (file, tasks) { 
fs.writerile{file, JSON.stringify(tasks}, 'utf8' 
if 【err) throw err; 


console.log('Saved,.'}: 
了 ) 


: function(err) { 


ee 数 storeTasks 实 现 aqdTask 功 能 。 
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代码 清单 5-6 添加 一 项 任务 
function addTask(file, taskDescription) { 
loadorIinitializeTaskArray (file, functionitasks) { 
tasks.push (taskDescription): 
storeTasks (file, tasks); 
}); 
} 


在 添加 程序 的 持久 化 功能 时 , 用 文件 系统 做 数据 存储 既 快 捷 又 容 多 。 用 它 来 保存 程序 配置 也 
很 好 。 如 采 程 序 的 配置 数据 保存 在 文本 文件 中 ， 并 且 编 码 为 JSON 格 式 ， 前 面 定 义 的 
loadorInitializeTaskArray 也 可 以 用 来 读 取 配置 文件 并 解析 JSON。 

第 13 草 会 介绍 更 多 与 Node 操 作文 件 系统 有 关 的 知识 。 接 下 来 我 们 去 看 看 在 程序 的 数据 存储 方 
面 一 二 占据 主力 位 置 的 关系 型 数据 管理 系统 。 


5.2 ”关系 型 数据 库 官 理 系统 


关系 数据 库 管理 系统 (RDBMS ) 可 以 存储 复杂 的 信息 , 并且 查 询 起 来 很 容 匈 。RDBMS 历来 
被 用 在 相对 高 闹 的 程序 上 ， 比 如 内 雁 管理 、 客 户 关 系 管理 和 购物 车 。 如 采 应 用 得 当 , 它们 能 表现 
得 很 好 , 但 使 用 它们 需要 具备 专业 的 管理 知识 , 并且 要 能 访问 数据 库 服 务 融 。 尺 管 有 对 象 关系 映 
射 (ORM ) API 可 以 帮 你 写 SQL， 但 你 还 是 要 有 SQL 方面 的 知识 。RDBMS 的 管理 ，ORM 和 SQL 
超出 了 本 书 的 范围 ， 但 网 上 有 很 多 介绍 这 些 技术 的 资源 。 

关系 型 数据 库 有 很 多 种 ,但 开发 人 员 一 般 会 选择 开源 数据 库 , 主要 是 因为 它们 有 很 好 的 文 持 ， 
好 用 , 而 且 不 用 花 一 分 钱 。 本 和 中 会 看 一 看 MySQL 和 了 PostgreSQL , 这 是 两 个 最 流行 的 全 功能 关系 
型 数据 库 。 MySQL 和 PostgreSQL 功 能 相似 ,并 且 痢 是 很 可 徘 的 选择 ,如 果 你 一 个 也 没 用 过 , MySQL 
设置 起 来 更 容易 ， 并 且 有 很 大 的 用 户 群 。 如 果 你 碰巧 使 用 有 版 权 的 Oracle 数 据 库 ， 则 需要 用 
db-oracle 模 块 ( https://github.com/mariano/node-db-oracle )， 这 也 不 在 本 书 的 范围 之 内 。 

让 我 们 先 从 MySQL 开 始 ， 然 后 再 看 PostgreSQL。 
























































5.2.1 MySQL 


MySQL 是 最 流行 的 SQL 数据 库 ，Node 社 区 对 它 的 支持 很 好 。 如 果 你 刚 接触 MySQL， 并 且 想 
尝 ， 可 以 去 看 官方 的 在 线 教程 ( http://dev.mysql.com/doc/refman/5.0/en/tutorial.html )。 对 于 SQL 新 
手 而 言 , 有 很 多 在 线 教程 和 书籍 可 以 帮 你 步 和 正轨, 包括 Chris Fehily 的 SQL 基础 教程 (第 3 版 ) (人 
民 邮 电 出 版 社 ，2009 年 ; 原 书 名 SQL: Visual QuickStart Guide ( Peachpit 出 版 社 ，2008) )。 

1. 用 MySQL 构 建 一 个 工作 跟踪 程序 

为 了 了 人 解 在 Node 中 如 何 使 用 MySQL, 我 们 来 看 一 个 需要 RDBMS 的 程序 。 假设 你 要 创建 一 个 
Web 程 序 ， 用 来 记录 你 是 如 何 度 过 工作 日 的 。 这 需要 记录 工作 的 日 期 ， 花 在 工作 上 的 时 间 ， 以 及 
工作 完成 情况 的 描述 。 

这 个 程序 会 有 个 表单 ， 用 来 输入 工作 的 详细 信息 ， 如 图 $-2 所 示 。 
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HON Mozilla Firefox = 






Archived Work Archived Work 
Sun Dec 30 2012 16:00:00 Worked on multi-room 
Date (YYYY-MM-DD): GMT-0800 (PST) 5 chat app. 
2012-12-31 
Date (YYYY-MM-DD): 
Hours worked: ee | 
5 
Hours worked: 
Description: 
Description: 

















Work details appear in list 


Work details entered 


图 5-2 ”记录 所 做 工作 的 详细 信息 


工作 信息 输入 后 ， 可 以 被 归档 或 被 删除 ， 让 它 不 再 显示 在 用 来 输入 更 多 工作 的 输入 域 上 方 ， 
如 图 $-3 所 示 。 点 击 “Archived Work” 链 接 可 以 把 之 前 归档 的 工作 项 全 都 显示 出 来 。 








O00 Mozilla Firefox SS 





Archived Work 














Sun Dec 30 2012 16:00:00 Worked on multi-room (Archive ) ( Delete ) 

GMT-0800 (PST) 3 chat app. 二 作 项 不 

Date (YYYY-MM-DD): ' 再 显 人 小 下 
入 

Hours worked: 

Description: 





扩 击 任意 一 个 按钮 ， 
工作 项 就 会 消失 


图 5-3 ”归档 或 删除 所 做 工作 的 详细 信息 


这 个 Web 程 序 可 以 用 文件 系统 做 简单 的 数据 存储 ， 但 那样 用 数据 做 报表 时 会 比较 复杂 。 比 如 
你 想 创建 一 个 上 周 所 做 工作 的 报表 ,就 必须 读 出 所 有 保存 下 来 的 工作 记录 并 检查 记录 的 日 期 。 如 
果 把 程序 数据 放 到 RDBMS 中 ， 用 SQL 查 询 生 成 报表 很 容易 。 

构建 工作 记录 程序 需要 完成 下 面 这 几 项 任务 : 

口 创建 程序 逻辑 ; 

口 创建 程序 工作 所 需 的 辅助 也 数 ; 

口 编写 让 你 可 以 用 MySQL 添 加 、 删 除 、 更 新 和 获取 数据 的 函数 ; 

口 编写 泻 染 HTML 记 录 和 表单 的 代码 。 
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这 个 程序 会 用 Node 内 置 的 http 模 块 实现 Web 服 务 胡 的 功能 , 用 一 个 第 三 方 模块 跟 MySQL 服 务 
人 船 交 互 。 一 个 名 为 timetrack 的 定制 模块 ， 它 是 程序 特有 的 纯 数 ,用 来 在 MySQL 中 人 存储、 修改 和 获 
取 数 据 。 图 5-4 是 这 个 程序 的 概 哆 。 





工作 记录 程序 


人 
timetrack_server.js 









Web 
训 览 器 









HTTP requests 
and responses 












mysql 模 块 











timetrack 模 块 








Add function 











图 5-4 ”工作 记录 程序 的 结构 


最 终结 来 如 图 5-5 所 示 , 一 个 可 以 用 来 记录 所 做 工作 的 简单 Web 程 序 , 还 可 以 回顾 、 归 档 及 删 
除 工作 记录 。 











HM Mozilla Firefox 一 
Archived Work 


A 和 -SR 
2012-03-13 6 Worked on front-end interface for issue tracker. ~ Sree Deete / 





人 2 » x 
2012-03-12 5 Working on REST interface for issue tracker. “Se / Deere) 


Date (YYYY-MM-DD): 





Hours worked: 





Description: 


TPR 
[ Add | 











图 5-5 ”一 个 可 以 用 来 记录 所 做 工作 的 简单 Web 程 序 
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为 了 让 Node 能 跟 MySQL 交 互 , 我 们 会 用 Felix Geisend6rfer 做 的 node-mysql 模 块 ( https://github. 
com/felixge/mode-mysql )。 先 用 下 面 这 条 命令 安装 这 个 很 受 欢 迎 的 MySQL Node 模 块 . 





npm install mysdl 

2. 创建 程序 的 逻辑 

接 下 来 需要 创建 两 个 文件 存放 程序 逻辑 。 这 个 两 个 文件 分 别 是 : timetrack serverjs， 用 来 局 
动 程 序 ; timetrack.js， 包 售 程 序 相 关 功 能 的 模块 。 

先 创 建 timetrack serverjs， 把 代码 清单 $-7 中 的 代码 放 到 里 面 。 这 上段 代码 包含 Node 的 HTTP 
APTl， 程序 特定 的 逻辑 以 及 MySQL API。 根据 你 的 MySQL 配 置 填 入 host、 user 和 password 这 
些 设 定 值 。 


代码 清单 5-7 ”程序 设置 及 数据 库 连 接 初始 化 


var http = require('http').; 





var work = require('./lib/timetrack').; | 引入 MySQL API 
var mysql = require('mysql'); 
var db = mysql.createConnection(t <F -== 连接 MySQL 

host: '127.0.0.1', 

USer: ‘myuser', 

Dassword: 'mypassword', 

database: 'timetrack' 


上 
接 下 来 添加 代码 清单 5-8 中 的 逻辑 , 定义 Web 程 序 的 行为 。 用 这 个 程序 可 以 浏览 、 添 加 和 删除 
工作 执行 记录 。 此 外 还 可 以 归档 工作 记录 。 被 归档 的 工作 记录 不 再 出 现在 主页 面 上 , 但 还 可 以 在 
-个 单独 的 Web 页 面 上 浏览 。 


代码 清单 5-8 ” HTTP 请 求 路 由 








Var server = http.createServer (function(req, res) { 
switch (req.method) { 
ase POST': < 一 HTTP POST 请 求 路 由 
switch(req.url) { 
Case '/': 
work.add (db, reg, res).: 
break; 


Case '/archive': 
woOrk.archive(db, redq, res).，: 
break; 

case '/delete': 
work.delete{(db, req, res): 
break; 











} 
break,; 
case 'GET': < 一 HTTP GET 请 求 路 由 
switch(req.url) { 
Case '/': 
work.show(db, res); 
break,; 


图 灵 社 区 会 员 quqingtao 专 享 尊重 版 权 


5.2 ”关系 型 数据 库 管 理 系统 95 


case '/archived': 
work.showArchived (db, res): 


} 
break; 


} 
Le 


代码 清单 53-9 是 timetrack_server.js 中 的 最 后 一 块 代码 。 这 上段 代码 创建 了 一 个 数据 库 表 ( 如果 不 
存在 的 话 ), 启动 HTTP 服务 需 , 监听 本 机 的 3000 端 口 。 所 有 的 node-mysq] 查 询 都 用 suery 困 数 执行 。 


代码 清单 5-9 ”创建 数据 库 表 
db .query ( 
"CREATE TABLE IE NOT EXISTS work (" < 一 建 表 SQL 
+ "id INT(10) NOT NULL AUTO_ INCREMENT, " 
+ "hours DECIMAL(5,2) DEFAULT 0, " 
+ "date DATE, " 
训 
于 





"archived INT(1) DEFAULT 0O, '" 
"description LONGTEXT," 
"PRIMARY KEY(id})})", 

function (err) f 
if (err) throw err; 








console.log('Server started...'); 

Server, Tistent(3000, 7127.0,0,.17; < 一 启动 HTTP 服 务 器 
| 
3. 创建 辅助 函数 发 送 HTML， 创 建 表 单 ， 接 收 表单 数据 

启动 程序 的 文件 已 经 完成 , 该 创建 定义 程序 其 他 功能 的 文件 了 。 创建 一 个 名 为 lib 的 目录 , 然 
后 在 这 个 目录 下 创建 文件 timetrack.js。 把 代码 清单 5-10 中 的 代码 放 到 这 个 文件 中 ， 其 中 包含 Node 
querystring API ， 并 定义 了 辅助 师 数 ， 用 来 发 送 Web 页 面 HIML， 接 收 通 过 表单 提交 的 数据 。 


代码 清单 5-10 ”辅助 孔 数 : 发 送 HIML， 创 建 表 单 ， 接 收 表单 数据 














var qs = regquire('gquerystring'); 
ExpDorte. Senditml = funcetion(reg, html} 1 < 一 发 送 HTML 了 应 
res.setHeader('Content-Type', 'text/html'); 


res.setHeader('Content-Length', Buffer.byteLength (html)); 
res.endl(html).; 
a 


expoOrts, DarseRecelvedData = funection(redq, Gb) 1 < 一 解析 HTTP POST 数据 
var body = ''; 
req.setEncoding('utf8').; 
req.on('data', function(chunk)}{ body += chunk }); 
req.on('end', function(}) { 
Var data = qs.parse (body)., 
cbldata).; 
上 
上 ; 
exports.actionForm = function(id, path, label) { < 一 泻 染 简单 的 表单 
Var html = '<form method="POST" action="' + path + '">' + 
'<input type="hidden" name="id" value="' + id + '">' + 
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'<input type="submit'" value="' + Jabel + '" />' + 
OTIS.!» 
return html; 


}; 
4. 用 MySQL 添 加 数据 

辅助 冰 数 到 位 了， 该 编写 往 MySQL 数 据 库 里 添加 工作 记录 的 代码 了 。 把 下 面 代码 清单 里 的 
代码 添加 到 timetrack.js 中 。 


代码 清单 5-11 添加 工作 记录 


exports.add = function(db, reqg, res) { 





exbortes. DarseRecelivedData (regq, function(worky) { < 一 解析 HTTP POST 数据 
db .query ( 
"INSERT INTO work (hours, date, description) " + 
加 工作 记 " VALUES (3?, ?, 2?)", 
录 的 SQL [work.hours, work.date, work.description], < 一 工作 记录 数据 


function(err) { 
1if (err) throw err; 
exportes. Show (dab, 元 Ge) ， < 一 给 用 户 显 示 工 作 记 录 清 单 
】 
人 
J 
注意 上 面 代码 中 的 问号 (? ),， 这 是 用 来 指明 应 该 把 参数 放 在 哪里 的 占 位 符 。 在 添加 到 查询 语 
句 中 之 前 ，query 方 法 会 自动 把 参数 转 义 ， 以 防 遭 受到 SQL 注 入 攻击 。 
此 外 还 要 留意 一 下 query 方 法 的 第 二 个 参数 ， 是 一 串 用 来 替代 占 位 符 的 值 。 
5. 删除 MySQL 数 据 
接 下 来 把 下 面 的 代码 添加 到 timetrack.js 中 ， 这 上段 代码 用 来 删除 一 条 工作 记录 。 


代码 清单 5-12 ”删除 工作 记录 














exports.delete = function(db, reqgq, res) { 
exports, DadreeReocelivedDatalred, function(weork}) 4 < 一 解析 HTTP POST 数据 
aqb .cuety ( 
"DELETE FROM work WHERE id=?", < 一 删除 工作 记录 的 SQL 
[work.id], < 一 工作 记录 ID 


function(err) { 
if (err) throw err; 
exports.show(db, res); < 一 给 用 户 显 示 工 作 记 录 清 单 
} 
); 
站 
}; 


6. 更 新 MySQL 数 据 
为 了 实现 更 新 工作 记录 的 逻辑 ， 将 它 标记 为 已 归档 ， 把 下 面 的 代码 添加 到 timetrack.js 中 。 
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代码 清单 5-13 ”归档 一 条 工作 记录 


exports.archive = function(db, reqgq, res) { 
exporte. DarseReceivedData (req, funcection (worky 1 < 一 解析 HTTP POST 数据 
db .aquery ( 
"UPDATE work SET archived=1 WHERE id=?", < 一 更 新 工作 记录 的 SQL 
[work.1id], , 
工作 记录 ID 


function(err) { 
if (err) throw err; 
exports.show (db, res); < 一 给 用 户 显示 工作 记录 清单 


Ly 
}; 


7. 获取 MySQL 数 据 

瀛 加 、 删 际 、 更 新 工作 记录 的 逻辑 已 经 定义 好 了 ， 现 在 可 以 把 代码 清单 5-14 中 的 逻辑 瀛 加 到 
到 timetrack 中 ， 用 来 获取 工作 记录 数据 ( 归档 的 或 未 归档 的 )， 从 而 把 它 演 染 为 HTML。 在 发 起 查 
询 时 传人 了 一 个 回调 函数 ， 它 的 参数 *ows 是 用 来 保存 返回 的 查询 结果 的 。 





代码 清单 5-14 ”获取 工作 记录 
exports.show = function(db, res, showArchived) { 
var query = "SELECT * FROM work " + < 一 获取 工作 记录 的 SQL 


"WHERE archived=? " + 
"ORDER BY date DESC".; 


Var archiveValue = (showArchived) ? 1 : 0; 
db .query ( 
query, 
[archiveValue]， < 一 想 要 的 工作 记录 归档 状态 


function(err, rows) { 
if (err) throw err; 
html = (showArchived) 
2 1 
'<a href="/archived">Archived Work</a><br/>'; 








html] += exports.workHitlistHtml (rows); < 一 将 结果 格式 化 为 HTML 表 格 
html += exports.workFormHtml ().; 
exports.sendHtml (res, html); < 一 给 用 户 发 送 HTML 响 应 
} 
) 
}; 
exports.showArchived = function(db, res) { 
exXDorte. Show (db, res; true): < 一 只 显示 归档 的 工作 记录 
] 
8. 浑 染 MySQL 记 录 
将 下 面 代码 清单 中 的 代码 添加 到 timetrack.js 中 。 它 会 将 工作 记录 演 染 为 HTML。 
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代码 清单 5-15 ”将 工作 记录 演 染 为 HTML 表 格 


ee function(rows) { | 将 每 条 工作 记录 泻 染 为 
for(var 1 in rows) { HTML 表 格 中 的 一 行 
Ptm] += '<tr>'; 
html += '<td>' + rows[i].date + '</td>'，; 
html += '<td>' + rows[i] .hours + '</td>'; 如 有 果 工作 记录 还 没 归档 ， 
html += '<td>' + Yows [1I].dqescription + '</La> ' 显示 归档 按钮 
if (I!Irows[i] .archived) { 
html += '<td>' + exports.workArchiveForm(rows[i] .id}) + '</tqd>'; 
} 
html += '<td>' + exports.workDeleteForm(rows[i].id}) + '</td>'; 





html += '</tr>'; 
} 
html += '</table>'.， 
return html:; 


}; 
9. 泻 染 HTML 表 单 
最 后 把 下 面 这 自演 染 HIML 表 单 的 代码 添加 到 timetrack.js 中 。 


代码 清单 5-16 ”用 来 添加 、 归 档 、 删 除 工 作 记 录 的 HTML 表 单 


exports.workFormHtml = function() { | 
var html = '<form method="POST" action="/">' + 录 的 空 月 HTML 表单 
'<p>Date (YYYY-MM-DD) :<br/><input name="date" type="text"><p/>' + 
'<p>Hours worked:<br/><input name="hours" type="text"><p/>' + 
'<p>Description:<br/>' + 
'<textarea name="description"></textarea></pP>' + 
'<input type="submit" value="Add" />' + 
'</form>'; 
return html; 
1 
,| 泻 染 归档 按钮 表单 


exports.workArchiveForm = function(id) { 
return exports.actionForm(id, '/archive', 'Archive').， 
}; 
. | 泻 染 钮 
exports.workDeleteForm = function(1id) { | 删除 按钮 表单 
return exports.actionForm(id, '/delete', 'Delete'),; 
}; 
10. 试 一 下 





程序 已 经 做 完了 ， 现 在 可 以 运行 了 。 记 得 先 用 MySQL 管 理工 具 创建 名 为 timetrack 的 数据 库 。 





然后 在 命令 行 中 用 下 面 的 命令 启动 程序 : 


node timetrack server.]s 





最 后 在 浏览 器 中 访问 http:/127.0.0.1:3000/ 。MySQL 可 能 是 最 流行 的 关系 型 数据 库 ， 但 对 很 





多 人 来 说 ，PostgreSQL 更 值得 导 僻 。 我 们 来 看 看 在 你 的 程序 里 如 何 使 用 PostgreSQL。 
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5.2.2 PostgreSQL 


PostgreSQL 因 其 与 标准 的 兼容 性 和 健壮 性 受到 认可 ,很 多 Node 开 发 人 员 对 它 的 喜爱 程度 超过 
ea 不 像 MySQL，PostgreSQL 支 持 递 归 查 询 和 很 多 特殊 的 数据 类 型 。PostgreSQL 

能 使 用 一 些 标准 的 认证 方法 ， 比 如 轻 量 目录 访问 协议 (LDAP ) 和 通用 安全 服务 应 用 程序 接口 
( ey 对 于 要 代 助 数据 复制 实现 扩展 能 力 或 见 余 性 的 那些 人 来 说 ，PostgreSQL 文 持 同 步 复 
制 ， 这 种 复制 形态 会 在 每 次 数据 操作 后 对 复制 进行 验证 ， 从 而 防止 数据 丢失 。 

如 果 你 刚 开始 接触 PostgreSQL， 可 以 通过 它 的 官方 在 线 教程 学 习 它 ( www.postgresql.org/ 
docs/7.4/static/tutorial.html )。 

最 成 熟 ， 并 且 也 是 最 活跃 的 PostereSQL API 模 块 是 Brian Carlson 的 node-postgres ( https://github. 
com/brianc/node-Postgres )。 


未 在 WINDOWS 下 测试 ”尽管 node-postgres 模 块 想 要 支持 Windows， 但 模块 的 创建 
者 主要 是 在 Linux 和 OS X 下 做 测试 ， 所 以 Windows 用 户 可 能 会 磁 到 问题 ， 比 如 在 安装 过 
程 中 出 现 致命 错误 。 因 此 Windows 用 户 可 能 想 用 MySQL， 而 不 是 PostgreSQL。 


可 以 用 下 面 的 命令 通过 npm 安 装 node-postgres : 

aot Tedatl So 

1. 连接 POSTGRESQL 

猴 好 node-postgres 模 块 后 ， 你 就 可 以 用 下 面 的 代码 连接 PostgreSQL ， 并 选择 一 个 数据 库 进 行 
查询 操作 〈 如 条 没有 设 定 密码 ， 请 忽略 连接 字 串 中 的 :mypassword 部 分 小 


Var py = require('pg'); 
var conSstring = "tcp://myuser:mypassword@localhost:5432/mydatabase"; 

















var client = new pg.Client (constring}):; 
client.connect(); 


2. 往 数 据 库 表 里 插入 一 条 记录 
query 方 法 执行 查询 操作 。 下 面 的 代码 展示 了 如 何 向 数据 库 表 中 插入 一 条 记录 : 


client.qaquery ll 
'INSERT INTO Users '"' + 
"(name) VALUES {('Mike')})'"' 
了 
占 位 符 0$1、$2 等 等 ) 可 以 指明 把 参数 放 在 哪里 。 在 添加 到 查询 语句 中 去 之 前 ， 每 个 参数 都 
会 被 转 义 ， 以 防 遭 受 SQL 注 入 攻击 。 下 面 是 使 用 占 位 符 插入 一 条 记录 的 例子 : 
client.query 
"TNSERT TNTO USers "™ + 


"(name, age) VALUES ($1, $2)", 
['Mike', 391] 








i 汪 
要 在 插入 一 条 记录 后 得 到 它 的 主键 值 ,可 以 用 RETURNING 从 名 加 上 列 名 指定 想 要 返回 哪 一 列 
的 伸 。 然 后 添加 一 个 回调 子 数 作为 query 调 用 的 最 后 一 个 参数 ,代码 如 下 所 示 : 
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client.queryl! 
"INSERT TINTO users " + 
" (name, age) VALUES ($1, $2) "+ 
"RETURNING id", 
['Mike', 39], 
function (err, result) { 
if (err) throw err,; 
console.log{'Insert ID is ' + result.rows[0] .1Q) ; 
} 
加 
3. 创建 返回 结果 的 查询 
如 有 果 你 准备 创建 一 个 将 要 返回 结果 的 查询 操作 ,就 需要 把 客户 问 query 方 法 的 返回 值 存放 到 
变量 中 。query 方 法 返回 的 是 一 个 继承 了 EventEmitter 的 行为 的 对 象 ,， 可 以 利用 Node 内 置 的 功 
能 。 这 个 对 象 每 取 回 一 条 数据 库 记 录 ， 就 会 发 出 一 个 row 事 件 。 代 码 清单 5-17 展 示 了 如 何 输出 查 


询 返 回 的 记录 中 的 数据 。 注 意 EBventEmitter 监 听 融 的 用 法 ,， 它 定义 了 如 何 处 理 数 据 库 表 中 的 记 
录 ， 以 及 在 数据 获取 完成 时 做 什么 。 


代码 清单 5-17 ”从 PostgreSQL 数 据 库 中 选择 记录 











~ 








Var dquery = client.queryl 
"SELECT * FROM users WHERE age > S$1", 
[40] 


.> 
处 理 返 回 的 记录 
query.on('row', function(row) { 
console.l1og (row.name) 


}); 
_。 | 查询 完成 后 的 处 理 


query.on('end', function() { 
client.end().; 
J 
取 回 最 后 一 条 记录 后 发 出 了 一 个 end 事 件 ， 可 以 用 它 关 闭 数 据 库 ， 或 者 继续 执行 程序 的 后 续 
逻辑 。 
关系 型 数据 库 是 传统 的 主力 ， 但 为 一 种 不 需要 使 用 SQL 的 数据 库 管理 系统 正在 迅速 蹄 红 。 


5.3 NoSQL 数据 库 


在 数据 库 世 界 刚 具 雏 形 之 时 ， 非 关系 型 数据 库 才 是 标准 。 但 关系 型 数据 库 淘 渐 兴起 ,成 为 主 
流 选 择 ， 在 不 在 Web 上 的 程序 都 会 用 它 。 最 近 儿 年 ， 非 关系 型 DBMS 隐 隐 有 复兴 之 势 ， 其 文 持 者 
宣称 它们 在 能 力 扩 展 和 多 用 性 上 比 关 系 型 数据 库 有 优势 ， 并 有 旦 这 些 DBMS 可 以 应 对 多 种 应 用 场 
景 。 大 家 将 它们 称 为 “NoSQL” 数 据 库 ， 即 “No SQL” 或 “Not Only SQL”。 

尽管 关系 型 DBMS 为 可 靠 性 牺牲 了 性 能 ， 但 很 多 NoSQL 数 据 库 把 性 能 放 在 了 第 一 位 。 因 此 ， 
对 于 实时 分 析 或 消息 传递 而 言 ，NoSQL 数 据 库 可 能 是 更 好 的 选择 。NoSQL 数 据 库 通常 也 不 需要 
预 完 定义 数据 schema, 对 于 那 种 要 把 数据 存储 在 层次 结构 中 , 但 层次 结构 却 会 发 生变 化 的 程序 而 
言 ， 这 很 有 帮助 。 
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本 节 会 介绍 两 个 流行 的 NoSQL 数 据 库 : Redis 和 MongoDB。 我 们 还 会 看 一 下 Mongoose， 一 
个 很 受 欢 迎 的 MongoDB 访 问 层 API， 它 有 一 些 可 以 帮 你 节省 时 间 的 功能 。Redis 和 MongoDB 的 设 
置 和 管理 超出 了 本 书 的 范围 ， 不 过 你 可 以 在 网 上 找到 Redis〈http:/redis.io/topics/quickstart ) 和 
MongoDB (http://docs.mongodb.ore/manual/installation/#installation-guides ) 的 快速 教程 ， 你 应 该 
能 按照 这 些 教程 把 它们 闭 好 跑 起 来 。 


5.3.1 Redis 


Redis 非 常 适合 处 理 那 些 不 需要 长 期 访问 的 简单 数据 存储 ， 比 如 短信 和 游戏 中 的 数据 。Redis 
把 数据 存在 RAM 中 ， 并 在 磁盘 中 记录 数据 的 变化 。 这 样 做 的 缺点 是 它 的 存储 空间 有 限 ， 但 好 处 
是 数据 操作 非常 快 。 如果 Redis 服 务 器 崩 演 ,RAM 中 的 内 容 丢 了 ,可 以 用 磁盘 中 的 日 志 恢 复数 据 。 

Redis 提 供 了 实用 的 原 语 命令 集 ( http://redis.io/commands )， 可 以 处 理 几 种 数据 结构 。Redis 
文 持 的 大 多 数 数据 结构 对 开发 人 员 来 说 并 不 卫生， 因为 它们 都 是 仿照 编程 中 常用 的 数据 结构 做 
的 : 哈 希 表 、 链 表 、 键 / 值 对 ( 作为 简单 的 变量 使 用 )。 哈 希 表 和 键 / 值 对 类 型 如 图 5-6 所 示 。Redis 
还 支持 一 种 稍微 有 点 儿 阴 生 的 数据 结构 ， 集 合 ( set )， 我 们 在 本 半 后 续 内 容 中 再 讨论 它 。 











名 称 值 


人 


包 侣 


图 5-6 ”Redis 文 持 几 种 简单 的 数据 类 型 ， 包 括 哈 希 表 和 键 / 值 对 


本 草 不 会 深入 探讨 Redis 的 所 有 命令 ， 但 我 们 会 做 几 个 对 大 多 数 程序 都 适用 的 例子 。 如 采 你 
刚 接 触 Redis ， 想 在 尝试 这 些 例子 之 前 建立 对 它 的 实用 性 的 概念 ， 教 程 “ 尝 试 Redis” 
( http://try.redis.io/ ) 是 个 很 好 的 起 点 。 要 深入 学 习 如 何 使 用 Redis， 请 看 Josiah L. Carlson 的 Redis in 
Action 一 书 ( Manning, 2013 )。 

最 成 熟 、 最 活跃 的 Redis API 模 块 是 Matt Ranney 的 node redis ( https://github.com/mranney/ 
node redis )。 用 下 面 这 条 npm 命 令 安装 它 : 





npm install redis 
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1. 连接 Redis 服 务 器 

下 面 的 代码 会 连接 到 运行 在 同一 主机 ,默认 TCP/ 耻 端口 上 的 Redis 服 务 需 。 你 创建 的 这 个 Redis 
客户 端 继承 了 EventEmitter 的 行为 ， 当 客户 端 跟 Redis 服 务 硕 通信 出 现 问 题 时 ， 它 会 抛 出 一 个 
ez 上 or 事件 。 如 下 例 所 示 ， 你 可 以 添加 error 事 件 类 型 的 监听 融 ， 定 义 目 己 的 错误 处 理 逻 辑 : 


var redis = require('redis').; 
var client = redis.createClient (6379, '127.0.0.1'); 





client.on({'error', function (err) { 
console.log('Error ' + err); 


小 由 

2. 操作 Redis 中 的 数据 

连 上 Redis 之 后 , 程序 可 以 马上 用 client 对 象 操作 数据 。 下 面 例子 中 是 存储 和 获取 键 / 值 对 的 
代码 : 











lient.set('color', 'red', dis. int); ， , - 

ee es ep i a ee { pe 
" ' 作 的 结果 , 或 在 
1f (err) throw err; 0 出 


Console.log('Got: ' + value); 


] ) 
3. 用 险 希 表 和 存储 和 获取 数据 
代码 清单 5-18 展 示 了 如 何 用 一 个 稍微 复杂 点 儿 的 数据 结构 ,， 哈 希 表 ， 也 被 称 为 哈 希 映射 ， 存 
储 和 获取 数据 。 哈 希 表 本 质 上 是 存放 标识 的 表 ， 这 些 标识 被 称 为 键 ， 与 相应 的 值 关 联 。 
Redis 命 令 hmset 设 定 哈 硕 表 中 的 元 素 ， 用 键 标识 值 。hkeys 列 出 哈 和 希 表 中 所 有 元 系 的 键 。 


代码 清单 5-18 在 Redis 哈 和 希 表 元 素 中 存放 数据 














client.hmset('camping', { 
'shelter': '2-person tent', 
'cooking': 'campstove'! 
}, redis.print); < 一 设 定 哈 希 表 元 素 
client.hget('camping', 'cooking', function(err, value) { ee 
i (err} throw errs 获取 元 素 "cooking" 的 值 
Console.log('Will be cooking with: ' + Value) ; 
}); 
client.hkeve('camping'; function(err, keva) 1 < 一 获取 哈 希 表 的 键 


if (err}) throw err:; 
keys.forEach(function(key, 1) { 
console.log{(' ' + kev): 
小 小 
1 
4. 用 链表 存储 和 获取 数据 
链表 是 Redis 文 持 的 男 一 种 数据 结构 。 如 果 内 存 足 够 大 ，Redis 链 表 理 论 上 可 以 存放 40 多 亿 条 
7 
下 面 是 在 链表 中 存储 和 获取 值 的 代码 。Redis 命 令 ljpush 丫 链表 中 添加 值 。lrange 获 取 参 数 
start 和 endq 范 围 内 的 链表 元 素 。 下 面 的 例子 中 ， 参 数 enq 为 -1， 表 明 到 链表 中 最 后 一 个 元 素 ， 
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所 以 这 个 lrange 会 取出 链表 中 的 所 有 元 素 : 








client.lpush('tasks', 'Paint the bikeshed red.', redis.print}).; 
client.lpush('tasks', 'Paint the bikeshed green.', redis.print}):; 
client.lrange('tasks', 0, -1, function(err, items) { 


if (err) throw err; 
items.forEach (function(item, 1) { 
console.l]og(! ' + item),; 
Pe 
}); 


Redis 链 表 是 有 序 的 字符 串 链表 。 如 果 你 要 创建 一 个 会 议 规划 程序 ， 可 以 用 链表 存储 会 议 的 
行程 。 

从 概念 上 讲 ，Redis 链 表 类 似 于 很 多 编程 语言 中 的 数组 ， 并 且 它 们 用 的 也 是 我 们 熟知 的 数据 
操作 办 法 。 人 然而 链表 的 缺点 在 于 从 中 获取 数据 的 性 能 。 随 看 链表 长 度 的 增长 ,数据 获取 也 会 逐渐 
芯 慢 ( 大 O 表 示 法 中 的 0(n)) 。 

大 OO 表示 法 ”在 计算 机 科学 中 ， 大 OO 表示 法 是 一 种 按 复杂 度 对 算法 分 类 的 方法 。 当 

你 看 到 用 大 0 表示 法 描述 的 算法 时 ， 能 快速 了 解 该 算法 的 性 能 。 如 果 你 不 了 解 大 0O，Rob 

Bell 的 “大 0 表示 法 初学 者 指南 ”能 帮 你 了 解 其 大 概 含义 〈http:/mng.bz/UJu7 )。 


5. 用 集合 存储 和 获取 数据 

Redis 集 合 是 一 组 无 序 的 字符 串 组 。 如 果 你 要 创建 一 个 会 议 规划 程序 ， 可 以 用 集合 存储 参 会 
者 的 信息 。 集 合 获取 数据 的 性 能 比 链 表 好 。 它 获取 集合 成 员 所 用 的 时 间 取 决 于 集合 的 大 小 (大 0 
表示 法 中 的 0(1) )。 

集合 中 的 元 素 必 须 是 唯一 的 , 如 果 你 试图 把 两 个 相同 的 值 存 到 集合 中 ,第 二 次 尝试 会 被 忽略 。 

下 面 是 在 集合 中 存储 和 获取 IP 地 址 的 代码 。Redis 命 令 sadd 尝 试 将 值 添加 到 集合 中 ， 
smembers 返 回 存 储 在 集合 中 的 值 。 在 这 个 例子 中 ，IP 地 址 204.10.37.96 被 添加 了 两 次 ,但 如 你 所 
见 ， 在 显示 集合 成 员 时 ， 这 个 地 址 只 会 出 现 一 次 : 












































client.sadd('ip addresses'，'204.10.37.96'，LTredqls.DrLnL) ， 
client.sadd('ip addresses', '204.10.37.96', redis.print): 
client.sadd('ip addresses', '72.32.231.8', redis.print}).; 
client.smembers('ip addresses', functionl(lerr, members}) { 





if (err) throw err; 
console.log (members}).; 


}); 
6. 用 信道 传 速 数据 

Redis 超 越 了 数据 存储 的 传统 职责 ， 它 提供 的 信道 是 无 价 之 宝 。 信 违 是 数据 传递 机 制 ， 提 供 
了 发 布 /预定 功能 ， 其 概念 如 图 5-7 所 示 。 对 于 聊天 和 游戏 程序 来 说 ， 它 们 很 实用 。 

Redis 客 户 端 可 以 癌 任 一 给 定 的 信道 预订 或 发 布 消 息 。 预 订 一 个 信道 意味 着 你 会 收 到 所 有 发 
送 给 它 的 消息 。 发 布 给 信 赴 的 消息 会 发 送 给 所 有 预订 了 那个 信 违 的 客户 端 。 
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Channel 


Subscriber Subscriber Subscriber 





图 5-7 Redis 的 信道 为 普通 的 数据 传递 场景 提供 了 一 种 简便 的 解决 方案 
代码 清单 5-19 中 是 一 个 用 Redis 的 发 布 /预订 功能 实现 的 TCP/IP 聊 天 服务 磊 。 
代码 清单 5-19 用 Redis 的 发 布 /预订 功能 实现 的 简单 聊天 服务 器 





var net = requirel('net').; . Ro > 
var redis = regquire('redis'); 为 每 1 连接 到 聊天 服务 器 
上 的 用 户 定 义 设置 逻辑 
Var Server = net.createServer (function(socket) { 
Var subscriber,; 
Var publisher:; 
为 用 户 创 建 
socket.on('connect', function() { 预订 客户 端 
预订 信道 subscriber = redis.createClient().; 有 
subscriber.subscribe('main chat room' ) ; 信道 收 到 消息 后 ， 
把 它 发 给 用 户 
subscriber.on('message', function(channel, message) { 
socket.write('Channel ' + channel + ': ' + message),; 
jj 为 用 户 创 建 发 布 
Publisher = redis.createClient ().; 各 厂 师 
}); 
socoket onl"data’, function(data) 1 | ， :sk 自 
Publisher.publish('main chat room', data); 用 丰 输入 消息 后 发 布 它 
}); 
socket.on('end', function() { 如 果 用 户 断 开 连 接 ,终止 


subscriber.unsubscribe('main chat_room' ) :; 客 尸 端 连接 
subscriber.end().; 

publisher.end().; 

- 
外 


server.listen(3000); < 一 启动 聊天 服务 器 
7. NODE REDIS 性 能 最 大 化 
在 你 准备 把 使 用 了 node redis API 的 Node.js 程 序 部 署 到 生产 环境 中 时 ， 可 能 要 考虑 下 是 否 使 
用 Pieter Noordhuis 的 hiredis 模 块 ( https://github.com/pietern/hiredis-node )。 这 个 模块 会 显著 提升 
Redis 的 性 能 ， 因 为 它 充 分 利用 了 官方 的 hiredis C 语 言 库 。 如 果 你 装 了 hiredis，node redis API 会 上 
动 使 用 hiredis 蔡 代 它 的 JavaScript 实 现 。 
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你 可 以 用 下 面 这 条 npm 命 令 安装 hiredis: 

npm install hiredis 

注意 ， 因 为 hiredis 库 是 用 C 代 码 编译 而 成 的 ， 而 Node 的 内 部 API 偶 尔 会 修改 ， 所 以 在 升级 了 
Node.js 后 ， 你 可 能 要 重新 编译 hiredis。 用 下 面 的 npm 命 令 可 以 重建 hiredis: 

npm rebuild hiredis 

看 过 了 擅长 高 性 能 数据 处 理 原 语 的 Redis， 接 下 来 我 们 去 看 一 个 更 通用 的 实用 数据 库 : 
MongoDB。 





5.3.2 MongoDB 


MongoDB 是 一 个 通用 的 非 关 系 型 数据 库 ， 使 用 RDBMS 的 那 类 程序 都 可 以 使 用 MongoDB。 

MongoDB 数 据 库 把 文档 存在 集合 ( collection ) 中 。 和 集合 中 的 文档 ， 如 图 5-8 所 示 ， 它 们 不 需 
要 相同 的 schema， 每 个 文档 都 可 以 有 不 同 的 schema。 这 使 得 MongoDB 比 传统 的 RDBMS 更 灵活 ， 
为 你 不 用 为 预先 定义 schema 而 操心 。 








Collection 
Document 


Name: “Rick” 


| Age' 23 











Document 





ltem ID: 12 | 








Amount: 45 | 














图 5-8 ”MongoDB 集 合 中 的 每 个 条 目 都 可 能 有 一 个 完全 不 同 的 schema 


最 成 熟 、 维 护 最 活跃 的 MongoDB API 模 块 是 Christian Amor Kvalheim 的 node-mongodb-native 
( https://github.com/mongodb/node-mongodb-native )。 你 可 以 用 下 面 的 npm 命 令 安 装 它 。Windows 
用 户 请 注意 ， 安 装 它 需要 有 Microsoft Visual Studio 安 装 后 提供 的 msbuild.exe: 

npm install mongodb 

1. 连接 MongoDB 

闭 好 node-mongodb-native， 运 行 你 的 MongoDB 服 务 磊 ， 用 下 面 的 代码 建立 服务 融 连 接 : 
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var mongodb = require('mongodb')}.; 
Var Server = new mongodb.SsServer('127.0.0.1', 27017, {1}}); 








var client = new mongodb.Db{('mydatabase', server, {w: 1}); 

2. 访问 MongoDB 集 合 

下 面 的 代码 片段 展示 了 如 何在 数据 库 连 接 打 开 后 访问 其 中 的 集合 。 如 果 在 数据 库 操作 完成 后 
你 想 关 闭 MongoDB 连 接 ， 可 以 执行 client .close(): 


client.open(function(err) { 





ift {err) throw err: 
client.collection{({'test insert', functionl(lerr, collection}y { 
IE (err) throw err.; 
console.log('We are now able to perform queries.'); 把 MongoDB 查询 代码 
人 放 在 这 里 
3. 将 文档 插入 集合 
下 面 的 代码 将 一 个 文档 插入 到 集合 中 ， 并 输出 其 独 有 的 文档 ID: 
collection.insert!l 
{ 
"title": "I like cake", 
"body": "It is gquite good." 安全 模式 表 阴 数据 库 操作 应 
j 该 在 回调 执行 之 前 完成 
{safe: true}, 





function(err, documents) { 
if (err) throw err; 
console.log('Document ID is: ' + documents[0]._ id).; 
} 
); 
安全 模式 ”在 查询 语句 中 声明 {safe: true} 表 明 你 想 让 数据 库 操 作 在 执行 回调 之 前 完 
成 。 如 果 你 的 回调 逻辑 对 即将 完成 的 数据 库 操 作 有 任何 形式 的 依赖 , 这 就 是 你 需要 的 选 
项 。 如 果 你 的 回调 逻辑 不 依赖 于 数据 库 操作 ， 可 以 用 邮 取 代 fsafe: true} 关 闭 安 全 模式 。 


人 


尽管 你 能 用 console.1og 将 aocuments [0] ._ id 显示 为 字符 串 ， 但 实际 上 它 不 是 字符 串 。 
MongoDB 的 文档 标识 符 是 二 进 制 JSON ( BSON )。BSON 是 MongoDB 用 来 交换 数据 的 主要 数据 格 
式 ，MongoDB 服 务 右 用 它 代 符 JSON 交 换 数 据 。 大 多 数 情况 下 , 它 更 世 省 空间 , 解析 起 来 也 更 快 。 
占用 更 少 空间 ， 扫 摘 更 容易 意味 着 数据 库 交 互 更 快 。 

4. 用 文档 ID 更 新 数据 

BSON 文 档 标 识 符 可 以 用 来 更 新 数据 。 下 面 的 代码 清单 展示 了 如 何 用 文档 的 ID 更 新 它 。 


代码 清单 5-20 ”更 新 MongoDB 文 档 


var id = new client.bson serializer 
.ObjectID('4e650d344ac74bS5sa0l1000001'); 

















collection.update! 
{_id: _id}, 
{Sset: {title": "I ate too much cake"}}, 
{safe: true}., 
function{({err) { 
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if (err} throw err， 
} 
) 
5. 搜索 文档 
你 可 以 用 find 方 法 搜索 MongoDB 中 的 文档 。 下 面 的 例子 展示 了 如 何 显示 集合 中 标题 为 "Ilike 
cake” 的 所 有 条 目 : 


collection.find({"title": "I like cake"}} .toArray! 
function(err, results) { 





if (err) throw err; 
console.log(lresults}).; 
} 
); 





6. 删除 文档 
想 删除 东西 ? 下 面 这 段 代 码 用 文档 的 内 部 ID ( 或 者 其 他 条 件 ) 把 它 删 除 : 
var id = new client 





.bson serializer 
.ObjectID('4e6513f0730d319501000001')】; 
collection.remove({ id: id}, {safe: true}, functionterr) f{ 
if (err) throw err; 


os 

MongoDB 是 一 个 强大 的 数据 库 ， 而 node-mongodb-native 提 供 了 高 性 能 的 MongoDB 访 问 ， 但 
你 可 能 想 用 一 个 抽象 的 数据 库 访问 API， 在 底层 帮 你 处 理 细 市 。 这 可 以 让 你 加 快 开 发 速度 ， 同 时 
维护 更 少 的 代码 。 这 些 API 中 最 流行 的 是 Mongoose。 








5.3.3 Mongoose 


Mongoose 是 LearnBoost 提 供 的 一 个 Node 模 块 ， 让 你 可 以 顺畅 地 使 用 MongoDB。Mongoose 的 
模型 (模型 -视图 -控制 硕 中 的 说 法 ) 提供 了 一 个 到 MongoDB 集 合 接 口 ， 以 及 一 些 实 用 的 功能 ， 
比如 schema 层 次 结构 ， 中 间 件 以 及 数据 校 验 。 schema 层 次 结构 可 以 让 一 个 模型 跟 其 他 模型 天 联 ， 
比如 说 ,让 一 篇 博客 文章 包含 相关 的 评论 。 中 间 件 可 以 转换 数据 ， 或 在 操作 模型 数据 的 过 程 中 触 
发 逻辑 ， 让 删除 父 数据 时 对 子 数据 的 修剪 这 样 的 任务 变 成 自动 化 的 。 Mongoose 的 校 验 文 持 让 你 
可 以 在 schema 层 面 决 定 什 么 样 的 数据 是 可 接受 的 ， 而 不 是 必须 手工 处 理 它 。 

尽管 我 们 的 重点 只 是 介绍 将 Mongoose 作 为 数据 存储 的 基本 用 法 ， 但 如 采 你 决定 使 用 Mongoose， 
学 习 一 下 它 的 在 线 文 档 ( http://mongoosejs.conmy )， 对 它 的 功能 做 一 个 全 面 了 解 ， 肯 定 大 有 神 益 。 

本 市 会 把 Mongoose 的 基础 知识 过 一 遍 ， 包 括 如 何 : 

口 打开 或 关闭 MongoDB 连 接 ; 

口 注册 schema; 

口 添加 任务 ; 

口 搜 索 文 档 ; 

口 更 新 文档 ; 

口 删除 文档 。 
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首先 ， 你 可 以 用 下 面 这 条 npm 命 令 安装 Mongoose: 

人 

1. 连接 的 打开 和 关闭 

装 好 Mongoose， 局 动 MongoDB 服 务 需 ， 用 下 面 的 代码 建立 到 MongoDB 的 连接 ,在 下 面 的 例 
子 中 是 一 个 叫 tasks 的 数据 库 : 


Var mongoose = require('mongoose').; 
var db = mongoose.connect('mongodb://localhost/tasks'):; 


如 果 要 终止 Mongoose 创 建 的 连接 ， 可 以 用 下 面 的 代码 关闭 它 : 
mongoose.disconnect ( ) : 


2. 注册 schema 
在 用 Mongoose 管 理 数 据 时 ， 需 要 注册 schema。 下 面 的 代码 为 任务 注册 了 一 个 schema: 


var Schema = mongoose.Schema: 

var Tasks = new Schemalt 
project: String, 
description: String 

is 


mongoose.model ('Task', Tasks); 

Mongoose 的 schema 很 强大 。 除 了 定义 数据 结构 ， 还 可 以 设 定 默 认 值 ， 处 理 输入 ， 以 及 加 强 
校 验 。 要 了 解 与 Mongoose schema 定 义 有 关 的 更 多 详情 ， 请 参见 Mongoose 的 在 线 文 档 
( http://mongoosejs.com/docs/schematypes.htm!l )。 

3. 添加 任务 

schema 注 册 好 后 ， 你 可 以 访问 它 ， 让 Mongoose 去 工作 。 下 面 的 代码 用 模型 添加 了 一 项 任务 : 

var Task = mongoose.model ({'Task'); 

var task = new Task!().; 

task.project = 'RBikeshed'; 

task.description = 'Paint the bikeshed red.';: 


task.save (function(err) { 
if {err} throw err:; 











console,.log('Task saved.').: 


le 
4. 搜索 文档 

用 Mongoose 做 搜索 也 一 样 容易 。Task 模 型 的 find 方 法 可 以 用 来 查找 所 有 文档 ， 或 者 用 一 个 
JavaScript 对 象 指明 过 滤 标 准 来 选择 特定 的 文档 。 下 面 这 段 代 码 搜 索 跟 特定 项 目 相关 的 任务 , 并 输 
出 每 项 任务 的 唯一 ID 和 摘 述 : 








var Task = mongoose.model{('Task'); 
Task.find{{'pProject': 'Bikeshed'}, functionl(lerr, tasks}) 1 
for {var 1 = 0; 1 < tasks.length; i++) { 
console.log{('ID:' + tasks[i]. id).: 











console.log(ltasks[1i] .description):; 
} 
上 
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5. 更 新 文档 
尽管 用 模型 的 find 方 法 可 以 定位 一 个 文档 ， 然 后 修改 并 保存 它 ， 但 Mongoose 还 有 一 个 
update 方 法 专门 来 做 这 个 。 下 面 的 代码 用 Mongoose 更 新 了 一 个 文档 : 


Var Task = mongoose.model('Task'); 
Task.update( 





{_id: '4e65b793d0cf5ca508000001'},， < 一 用 内 部 ID 更 新 
{description: 'Paint the bikeshed green.'}, 
{multi: false}, < 一 只 更 新 一 个 文档 


function(err, rows updated) 1 
if (err}) throw err:; 
console,.log('Updated.'}).: 
} 
); 
6. 删除 文档 
在 Mongoose 中 ,一 旦 你 取 到 了 文档 ， 要 删除 它 很 容易 。 你 可 以 用 文档 的 内 部 ID (或 其 他 任 


何 条 件 ， 如 采 你 用 finq 代 替 findqByIdq 的 话 ) 获取 和 删除 文档 ， 代 码 就 像 下 面 这 样 : 


var Task = mongoose.model{('Task'); 
Task.ftindById{('4e65b3dcel592f7d08000001', functionlterr, task) f{ 
task.removel(). 


ji 
Mongoose 中 还 有 很 多 等 着 你 去 探索 的 东西 。 它 是 一 个 全 能 的 优秀 工具 ， 能 跟 灵 活 高 效 的 
MongoDB 相 匹配 ， 又 不 失传 统 的 关系 型 数据 库 管 理 系统 所 具备 的 多 用 性 。 


5.4 ”小结 


现在 你 对 数据 存储 技术 有 了 稳健 的 认识 ,掌握 了 人 处理 和 常见 数据 存储 场景 所 需 的 基础 知识 。 

如 果 你 正在 创建 多 用 户 的 Web 程 序 ， 很 可 能 会 用 一 个 DBMS 或 类 似 的 东西 。 如 果 你 喜欢 基于 
SQL 的 处 理 方式 , 关系 型 数据 库 管理 系统 MySQL 和 PostgreSQL 都 得 到 了 很 好 的 支持 。 如 采 你 发 现 
SQL 在 性 能 或 灵活 性 上 表现 欠 佳 ，Redis 和 MongoDB 都 是 坚 如 兢 石 的 可 选项 。MongoDB 是 极 佳 的 
通用 DBMS ， 而 Redis 擅 长 处 理 变化 频 系 ， 相 对 比较 简单 的 数据 。 

如 果 你 不 需要 一 个 花 里 胡 哨 的 、 全 面 的 DBMS ， 想 要 避免 设置 上 的 麻烦 ， 你 有 几 个 选项 。 如 
果 速 度 和 性 能 是 关键 , 并 且 你 不 关心 程序 重启 后 的 数据 持久 化 ， 内 存 存储 可 能 很 适合 你 。 如 果 你 
不 关心 性 能 ,也 不 需要 做 复杂 的 数据 查询 ， 就 像 一 个 典型 的 命令 行程 序 一 样 ， 把 数据 存在 文件 中 
可 能 可 以 满足 你 的 需要 。 

你 可 以 在 程序 中 使 用 多 种 存储 机 制 。 比 如 说 ， 如 果 你 要 构建 一 个 内 容 管理 系统 ,可 能 会 用 文 
件 存 储 Web 程 序 的 配置 选项 ， 用 MongoDB 存 储 文 草 ， 用 Redis 存 储 用 户 给 出 的 文 草 评级 。 如 何 实 
现 持久 化 完全 取决 于 你 的 想象 力 。 

Web 程 序 开 发 和 数据 持久 化 的 基本 知识 已 经 尽 在 掌握 ， 你 已 经 学 会 了 创建 一 个 简单 的 Web 程 
序 所 需 的 基础 知识 。 现 在 , 请 做 好 准备 进入 测试 领域 , 这 是 一 项 可 以 确保 你 现在 编写 的 代码 将 来 
能 用 的 一 项 重要 技能 。” 





























Q) 实际 上 下 一 章 要 讲 Connect， 第 10 章 才 会 讲 测试 ， 作 者 可 能 忘 了 改 了 。 一 -一 译 者 注 
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Connect 





本 章 内 容 

口 搭建 一 个 Connect 程 序 

口 Connect 中 间 件 的 工作 机 制 
口 为 什么 中 间 件 的 顺序 很 重要 
口 挂 载 中 间 件 和 服务 需 

口 创建 可 配置 的 中 间 件 

D 使 用 错误 处 理 中 间 件 


Connect 是 一 个 框架 , 它 使 用 被 称 为 中 间 件 的 模块 化 组 件 , 以 可 重用 的 方式 实现 Web 程 序 中 的 
逻辑 。 在 Connect 中 ， 中 间 件 组 件 是 一 个 函数 ， 它 拦截 HTTP 服 务 右 提供 的 请 求 和 啊 应 对 象 ， 执 行 
逻辑 ， 然 后 或 者 结束 啊 应 ,或 者 把 它 传递 给 下 一 个 中 间 件 组 件 。Connect 用 分 派 带 把 中 间 件 “ 连 
接 ” 在 一 起 。 

在 Connect 中 ， 你 可 以 使 用 上 自己 编写 的 中 间 件 ,但 它 也 提供 了 几 个 常用 的 组 件 ， 可 以 用 来 做 
请 求 日 志 、 静 态 文件 服务 、 请 求 体 解析 、 会 话 管理 等 。 对 于 想 构 建 自己 的 高 层 Web 框 架 的 开发 人 
员 来 说 ，Connect 就 像 一 个 抽象 展 ， 因 为 Connect 很 容易 扩展 ， 在 其 上 构建 东西 也 很 容易 。 图 6-1 
展示 了 如 何 用 分 派 希 和 中 间 件 构造 一 个 Connect 程 序 。 











Connect 和 Express 
本 章 所 讨论 的 概念 可 以 直接 套用 到 更 高 层 的 Express 框 架 上 ， 因 为 它 就 是 构建 在 Connect 上 
的 扩展 ， 添 加 了 更 多 高 层 的 糖衣 。 看 完 这 一 章 ， 你 会 对 Connect 中 间 件 的 工作 机 制 ， 以 及 如 何 
组 装 这 些 组 件 创建 一 个 程序 有 个 确切 的 认识 。 
到 第 8 和 章 ， 我 们 会 用 Express 提 供 的 更 高 层 API 编 写 Web 程 序 ， 比 用 Connect 更 有 趣 。 实 际 上 ， 
Connect 现 在 提供 的 很 多 功能 都 起 源 于 Express， 在 作出 抽象 之 前 (将 底层 构件 留 给 Connect， 让 
Express 保 留 富 于 表现 力 的 糖衣 )。 


要 开始 了 ， 让 我 们 先 创 建 一 个 简单 的 Connect 程 序 吧 1 
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GET /img/logo.pn POST /user/save a se 机 
pe @ 分 派 器 收 到 请 求 ， 把 它 传 给 
第 一 个 中 间 件 


Dispatcher 


四 记录 请 求 日 志 ， 并 用 next () 传 
给 下 一 个 中 间 件 


mexXt ( ) 


logger 


@ 如 果 有 ， 请 求 体会 被 解析 ， 并 
用 next ( ) 传 给 下 一 个 中 间 件 


next ( ) 


bodyParser 
PR 那个 文件 做 响应 ， 不 再 调用 
next ( ) 否则 请 求 进 入 下 一 个 
next () @@ 请 求 被 一 个 定制 的 中 间 件 处 
理 好 ， 啊 应 结束 


customMiddleware res.end() 全 


半 


6-1 两 个 HTTP 请 求 穿 过 Connect 服 务 器 的 生命 周期 


6.1 搭建 一 个 Connect 程序 


Connect 是 第 三 方 模块 ， 所 以 它 不 在 Node 的 默认 安装 之 列 。 你 可 以 用 下 面 的 命令 从 npm 注 册 
中 心 下 载 Connect 并 安 疙 它 : 

s npm install connect 

现在 安装 已 经 不 是 问题 了 ,我 们 开始 创建 这 个 简单 的 Connect 程 序 吧 ,为 此 你 需要 引入 connect 
模块 ， 调 用 这 个 国 数 时 ， 它 能 返回 一 个 Connect 裸 程序 。 

在 第 4 章 中 , 我 们 讨论 过 http .createServez() 如 何 接受 一 个 回调 函数 来 处 理 传人 的 请 求 。 
Connect 创 建 的 “程序 ”实际 上 是 一 个 JavaScript 国 数 ， 用 来 接收 HTTP 请 求 并 把 它 派 发 给 你 指定 的 
中 间 件 。 

代码 清单 6-1 给 出 了 最 小 的 Connect 程 序 是 什么 样子 。 这 个 裸 程序 没有 中 间 件 ， 所 以 分 派 郑 会 
用 404 Not Found 状 态 人 码 啊 应 它 收 到 的 所 有 HTTP 请 求 。 


代码 清单 6-1 最 小 的 Connect 程 友 


Var Connect = require('connect').; 
var app = Connect().; 
app.listen(3000); 


启动 这 个 服务 需 , 用 curl] 或 浏览 需 给 它 发 送 一 个 HTTP 请 求 ， 你 会 看 到 “CannotGET/”， 表 明 
这 个 程序 还 不 能 处 理 你 请 求 的 URL。 这 是 演示 Connect 的 分 派 器 如 何 工作 的 第 一 个 例子 ， 它 依次 
调用 所 有 附着 的 中 间 件 组 件 , 直到 其 中 一 个 决定 啊 应 该 请 求 。 如 果 直 到 中 间 件 列表 末尾 还 没有 组 
件 决定 响应 ,程序 会 用 404 作 为 啊 应 。 
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你 已 经 学 会 如 何 创 建 一 个 最 基本 的 Connect 程 序 了 ， 也 知道 分 派 硕 是 如 何 工 作 的 ， 接 下 来 我 
们 看 看 如 何 通 过 定义 和 添加 中 间 件 让 这 个 程序 做 点 儿 事 。 


6.2 Connect 的 工作 机 制 


在 Connect 中 ， 中 间 件 组 件 是 一 个 JavaScript 函 数 ， 按 惯例 会 接受 三 个 参数 : 一 个 请 求 对 象 ， 
一 个 啊 应 对 象 ， 还 有 一 个 通常 命名 为 next 的 参数 ， 它 是 一 个 回调 函数 ， 表 明 这 个 组 件 已 经 完成 
了 它 的 工作 ， 可 以 执行 下 一 个 中 间 件 组 件 了 。 

中 间 件 的 概念 最 初 是 有 党 到 了 Ruby 的 Rack 框 架 的 司 发 ， 它 有 一 个 非 稼 相似 的 模块 接口 ， 但 由 
于 Node 的 流 特性 ， 它 的 API 与 其 不 同 。 中 间 件 组 件 很 棒 ， 因 为 它们 小 巧 、 目 包含 ， 并 且 可 以 在 整 
个 程序 中 重用 。 

这 一 节 要 学 习 中 间 件 的 基础 知识 ， 我 们 会 继续 使 用 前 一 节 那 个 Connect 侍 程序 ， 在 其 中 构建 
两 个 简单 的 中 间 件 层 : 

口 一 个 1ogger 中 间 件 组 件 将 请 求 输 出 到 控制 合 中 ; 

口 一 个 hello 中 间 件 组 件 ， 用 “hello world” 啊 应 请 求 。 

我 们 先 来 创建 将 服务 需 收 到 的 请 求 记 录 下 来 的 中 间 件 组 件 。 


6.2.1 做 日 志 的 中 间 件 


假设 你 想 创建 一 个 日 志文 件 来 记录 进入 服务 需 的 请 求 方法 和 URL。 为 此 你 需要 创建 一 个 项 
数 ， 我 们 就 叫 它 1oggezr 吧 ， 它 有 三 个 参数 : 请 求 和 啊 应 对 象 ， 以 及 回调 晒 数 next。 

next 也 数 可 以 在 中 间 件 里 调用 ， 告 诉 分 派 帮 这 个 中 间 件 已 经 完成 了 自己 的 任务 ， 可 以 把 控 
制 权 交 给 下 一 个 中 间 件 组 件 了 。 用 回调 子 数 ,而 不 是 从 方法 中 返回 ,是 为 了 可 以 在 中 间 件 组 件 里 
运行 异步 逻辑 , 这样 分 派 带 就 只 能 等 者 前 一 个 中 间 件 组 件 完成 后 才 会 进入 下 一 个 中 间 件 组 件 。 用 
next () 处理 中 间 件 组 件 之 间 的 流程 是 不 错 的 机 制 。 

对 于 logger 中 间 件 组 件 , 你 可 以 市 着 请 求 方法 和 URL 调 用 console.1og() ,输出 一 些 “GET 
/user/1” 之 类 的 东西 ， 然 后 调用 next () 函数 将 控制 权 交 给 下 一 个 组 件 : 


function loggerlreg, res, next) f 




































































Console.1logl'%s Ss', reg.method, reg.url): 
next {().; 


) 
就 是 它 了 ， 一 个 完 闫 的、 有 效 的 中 间 件 组 件 ， 可 以 输出 每 个 HTTP 请 求 的 方法 和 URL， 然 后 
调用 next () 将 控制 权 交 给 分 派 涡 。 要 在 程序 中 使 用 这 个 中 间 件 ,你 可 以 调用 .use() 方 法 ， 把 中 














间 件 函数 传 给 它 : 
Var Connect = require('connect'); 
var app = connectr); 


aDD .USe (logger). 
abpp.listen(3000); 


用 curl 或 浏览 瘟 问 服务 侣 发 起 了 几 个 请 求 后 ， 你 应 该 能 在 控制 台中 看 到 下 面 这 种 输出 : 
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GET 7 

GET /favicon.ico 
GET /USers 

GET /usSer/1 


记录 请 求 只 是 第 一 层 中 间 件 。 你 还 需要 给 客户 只 发 送 采种 啊 应 。 那 是 你 的 下 一 个 中 间 件 。 














6.2.2 ”响应 “hello world” 的 中 间 件 


这 个 程序 中 的 第 二 个 中 间 件 组 件 会 给 HTTP 请 求 发 送 啊 应 。 跟 Node 首 页 上 那个 “hello world” 
服务 器 里 的 回调 函数 一 样 : 
function hellofreGd，Lres) { 
res.setHeader('Content-Type', ‘text/pPlain').: 


res.,end('hello world'): 


) 

你 可 以 调用 .use() 方 法 把 第 二 个 中 间 件 组 件 添加 到 程序 中 ， 这 个 方法 可 以 调用 任意 多 次 ， 
添加 更 多 的 中 间 件 。 

代码 清单 6-2 把 整个 程序 拼 到 一 起 。 这 段 代码 这 样 添 加 hel1lo 中 间 件 组 件 ， 会 让 服务 器 首先 
调用 logger， 先 向 控制 台中 输出 文本 ， 然 后 用 “hello world” 啊 应 每 个 HTTP 请 求 : 


代码 清单 6-2 ”使 用 多 个 Connect 中 间 件 组 件 

















Var connect = requlire('connect').; 给 出 HTTP 请 求 的 方法 和 URL 并 调用 
function logger(req, res, next) { next () 

Console.log('%s %s', req.method, reqgq.url); 

next ( ) ; 


} 
间 用 “hello world” 响 应 HTTP 请 求 


function hello(req, res) { 
res.setHeader('Content-Type', 'text/plain'); 
res.end('hello world'); 


} 


connect ( ) 
.USe (logger) 
.Use lhello) 
.listen(3000),， 


在 这 个 例子 中 ， 中 间 件 组 件 hello 的 参数 中 没有 next 回 调 。 因 为 这 个 组 件 结束 了 HTTP 啊 应 ， 
从 不 需要 把 控制 权 交 回 给 分 派 带 。 对 于 这 种 情况 ，next 回 调 是 可 选 的 ， 因 为 这 样 跟 
http.createServer 回调 函数 的 签名 一 人 致 ， 所 以 更 方便 。 也 就 是 如 果 你 已 经 写 了 -个 只 使 用 http 
模块 的 HIT 服 务 带 , 你 就 已 经 有 了 一 个 完美 的 有 效 的 中 间 件 组 件 , 可 以 在 你 的 Connect 程 序 中 重用 。 

就 像 前 面 代码 中 写 的 那样 , use () 函数 返回 的 是 文 持 方 法 链 的 Connect 程 序 实例 。 注 意 , .use () 
的 链 式 调用 不 是 必须 的 ， 比 如 下 面 这 段 代码 : 

var app = Connect{);: 

aDD.uUuSe (logger). 


app.usel(hello}).; 
app.listen(3000); 
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这 个 简单 的 “hello world” 程 序 可 以 用 了 ， 接 下 来 我 们 要 看 看 为 什么 中 间 件 .use () 调 用 的 顺 
序 很 重要 ， 以 及 如 何 策略 性 地 调整 顺序 改变 程序 的 工作 方式 。 


6.3 为 什么 中 间 件 的 顺序 很 重要 


为 了 让 程序 和 框架 开发 人 员 得 到 最 大 的 灵活 性 ，Connect 尽 量 不 做 假设 。Connect 人 允许 你 定义 
中 间 件 的 执行 顺序 束 是 例证 之 一 。 这 是 一 个 简单 的 概念 ， 但 经 稼 被 忽视 。 

你 将 在 本 市 中 见 到 中 间 件 在 程序 中 的 顺序 如 何 对 它 的 行为 方式 产生 显著 的 影响 。 具 体 来 说 ， 
我 们 会 涵盖 如 下 几 项 内 容 : 

口 忽略 next () 从 而 停止 后 续 中 间 件 的 执行 ; 

口 按照 对 你 有 利 的 方式 使 用 强大 的 中 间 件 顺序 特性 ; 

口 利用 中 间 件 进行 认证 。 

我 们 先 来 看 看 Connect 如 何 处 理 显 式 调用 了 next () 的 中 间 件 组 件 。 


6.3.1 中 间 件 什么 时 候 不 调用 next () 


考虑 下 前 面 这 个 “hello world” 的 例子 ， 先 用 了 logger 中 间 件 组 件 ， 接 着 是 nello 组 件 。 在 
这 个 例子 中 ，Connect 回 stdout 中 输出 日 志 ， 然 后 啊 应 HITP 请 求 。 请 你 考虑 考虑 如 果 改 变 一 下 顺 
序 会 怎么 样 ， 如 下 所 示 。 


代码 清单 6-3 ”人 蚀 误 : hello 中 间 件 组 件 在 1oggez 组 件 前 面 









































Var connect = redqulrel(' connect ' ) ; 

ee 0)， 所 以 后 续 中 
RE 四 ai 件 总 会 被 调用 

a 

function hello(req, res) { en 
res.setHeader('Content-Type', 'text/plain'); 全 玫 而 nexE 0 ， 因 为 组 
res.end('hello world'); 件 响 应 了 请 求 

} 

Var app = connect() 
.USse (hello) . 
.USEe (logger) BevLo NN emt ()， 所 
.listen(3000); 以 logger 永 远 不 会 被 调用 


在 这 个 例子 中 ，hello 中 间 件 组 件 先 被 调用 ， 并 如 期 啊 应 HTTP 请 求 。 但 因为 hel1o 不 会 调 
用 next () ， 控 制 权 就 不 会 被 区 回 到 分 派送 去 调用 下 一 个 中 间 件 组 件 ， 所 以 1oggez 永 远 也 不 会 被 
调用 。 我 要 说 的 是 ， 当 一 个 组 件 不 调用 next () 时 ， 命 令 链 中 的 后 续 中 间 件 都 不 会 被 调用 。 

在 这 个 例子 中 ， 把 hello 放 到 loggezr 前 面 这 无 用 处 ， 但 如 宁 应 用 得 当 ， 人 安排 好 顺序 可 以 给 
你 市 来 好 处 。 
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6.3.2 ”用 中 间 件 的 顺序 执行 认证 


你 可 以 按照 对 你 有 利 的 顺序 安排 中 间 件 ， 比 如 在 需要 做 认证 时 。 几 乎 所 有 程序 都 会 做 认证 。 
用 户 需 要 通过 某 种 方式 登录 , 而 你 需要 防止 没有 登录 的 人 访问 某 些 内 容 。 中 间 件 的 顺序 可 以 帮 你 
实现 认证 。 

假设 你 已 经 写 了 一 个 叫做 restrictFileAccess 的 中 间 件 组 件 ， 只 人 允许 有 效 的 用 户 访问 文 
件 。 有 效用 户 可 以 继续 到 下 一 个 中 间 件 组 件 ， 如 果 用 户 无 效 ， 则 不 会 调用 next ()。 在 下 面 的 代 
人 码 清 单 中 ， 中 间 件 组 件 restrictFileAccess 跟 在 中 间 件 组 件 logger 之 后 ,但 在 
serveStaticFiles 组 件 之 前 。 


代码 清单 6-4 用 中 间 件 的 位 次 限制 文件 访问 


























Var Connect = require('connect').; 

connect ( ) 
-et looder) 间 只 有 用 户 有 效 时 才 会 调用 next () 
.USe (restrictFileAccess) 


.USe (serveStaticFiles) 
.use (hello); 


讨论 完 中 间 件 的 顺序 , 以 及 它 对 构造 程序 逻辑 的 重要 性 , 接 下 来 我 们 去 看 男 外 一 个 对 你 使 用 
中 间 件 有 帮助 的 Connect 特 性 。 


6.4 ” 挂 载 中 间 件 和 服务 


Connect 中 有 一 个 挂 载 的 概念 ， 这 是 一 个 价 单 而 强大 的 组 织 工 具 ， 可 以 给 中 间 件 或 整个 程序 
定义 一 个 路 径 前 级。 使 用 挂 载 ,你 可 以 像 在 根 层次 下 那样 编写 中 间 件 (/ 根 regq.url )， 并且 不 修 
改 代码 就 可 以 把 它 用 在 任 一 路 人 径 前 级 上 。 

比如 说 ， 如 果 一 个 中 间 件 组 件 或 服务 各 挂 载 到 了 /blog 上 ， 代 码 中 /article/1 的 req.url 通 
过 客户 并 来 访问 就 是 /blog/article/1。 这 种 分 离间 味 着 你 可 以 在 多 个 地 方 重用 博客 服务 带 ， 
不 用 为 不 同 的 访问 源 修改 代码 。 比 如 说 ， 如 果 你 决定 改 用 /articles ( /articles/article/1 ) 提供 文章 服 
务 ， 不 再 用 /blog 了 了， 只 要 修改 挂 载 路 径 前 级 就 可 以 了 。 

我 们 再 看 一 个 挂 载 的 例子 。 程 序 通 稼 都 有 它们 目 己 的 管理 区 域 , 比如 干预 评论 和 批准 新 用 户 。 
在 我 们 的 例子 中 ， 这 个 管理 区 域 会 放 在 /admin 上。 你 需要 有 办 法 确保 只 有 被 授权 的 用 户 才能 访问 
/admin， 而 网 站 的 其 他 区 域 对 所 有 用 户 都 是 开放 的 。 

除了 为 / 根 *eq.ur1 重 写 请 求 ， 挂 载 还 将 只 对 路 径 前 绥 〈 挂 载 点 ) 内 的 请 求 调用 中 间 件 或 程 
序 。 在 后 面 的 代码 清单 中 ,第 二 个 和 第 三 个 user () 调 用 中 的 第 一 个 参数 是 字符 串 ' /admin' ， 然 
后 是 中 间 件 组 件 。 这 意味 着 这 些 组 件 只 用 于 带 有 /agdmin 前 级 的 请 求 。 我 们 来 看 一 下 Connect 中 挂 
载 中 间 件 组 件 或 服务 融 的 霹 法 。 














引 
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代码 清单 6-5 ” Connect 中 挂 载 中 间 件 组 件 或 服务 带 的 语法 


Var Connect = require('connect').; 
当 .use() 的 第 一 个 参数 是 个 字符 串 时 ， 
只 有 URL 前 缀 与 之 匹配 时 ，Connect 才 
Ee | 会 调用 后 面 的 中 间 件 
.USe('/admin', restrict) 
.USe('/admin', admin,) 


.use (hello) 
.listen(3000); 


擎 握 了 中 间 件 和 服务 益 挂 载 的 知识 ， 我 们 来 改进 下 “hello world” 程 序 ， 给 它 添加 一 个 管理 
区 。 我 们 会 用 到 挂 载 ， 并 添加 两 个 新 的 中 间 件 组 件 : 

口 restrict 组 件 确 保 访 问 页 面 的 是 有 效用 户 ; 

口 aqmin 组 件 会 给 用 户 呈 现 管理 区 。 

我 们 先 从 防止 无 效用 户 访问 资源 的 中 间 件 组 件 开 始 。 


6.4.1 认证 中 上 间 件 


你 要 添加 的 第 一 个 中 间 件 组 件 会 对 用 户 进 行 认 证 。 这 是 一 个 通用 的 认证 组 件 , 不 会 以 任何 方 
式 专门 绑 定 在 /adamin req.ur1l 上 。 但 当 你 把 它 挂 载 到 程序 上 时 ， 只 有 请 求 URL 以 /admin 开 始 时 ， 
才 会 调用 它 。 这 很 重要 ， 因 为 你 只 想 对 试图 访问 /aqmin URL 的 用 户 进 行 认 证 ， 让 常规 用 户 仍 能 
照 浓 通行 。 

代码 清单 6-6 实 现 了 人 简陋 的 Basic 认 证 欣 辑 。Basic 认 证 是 一 种 简单 的 认证 机 制 ， 借 助 达 关 
Base64 编 码 认证 信息 的 HTTP 请 求 涉 中 的 authorization 字 上段 进 行 认证 (详情 请 参见 维基 百科 : 
http://wikipedia.org/wiki/Basic access_authentication )。 中 间 件 组 件 解 码 认 证 信息 ， 检 查 用 户 名 和 
密码 的 正确 性 。 如 果 有 效 ， 这 个 组 件 会 调用 next () ， 表 明 这 个 请 求 没 有 问题 ， 可 以 继续 处 理 ， 
否则 它 会 抛 出 一 个 错误 。 


代码 清单 6-6 ”实现 HTTP Basic 认 证 的 中 间 件 组 件 


function restricttreg, res, next) { 






































var authorization = req.headers.authorization,; 

if (lauthorization) return next (new Error('Unauthorized')}). 

Var parts = authorization.split(' ') 

Var Scheme = parts[0] 

Var auth = new Buffer(parts[1], 'base64') .toString() .split(':') 

var user = autn[o] 

var pass = auth[1]; 有 
1 人 了 三 自 “| 2J< 类 

authenticateWithDatabase (user, pass, function (err) { 认证 信息 的 函数 


if (err) return next (ez) :; | 
告诉 分 派 器 出 错 了 
next (); 全 
js 如 果 认 证 信息 有 效 , 不 带 
} 参数 调用 next () 


再 次 重申 , 这 个 中 间 件 没有 检查 req .url 以 确保 用 户 请 求 的 是 /admin, 因为 Connect 已 经 带 我 
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们 处 理 好 了 。 这 样 你 就 可 以 写 出 通用 的 中 间 件 。restrict 中 间 件 可 以 用 来 认证 网 站 的 其 他 部 分 
或 其 他 程序 。 
用 Error 做 参数 调用 next 注意 前 面 例 子 中 用 Error 对 象 做 参数 的 next 函 数 调 用 。 

这 相当 于 通知 Connect 程 序 中 出 现 了 错误 ， 也 就 是 对 于 这 个 HTTP 请 求 而 言 ， 后 续 执行 的 

中 间 件 只 有 错误 处 理 中 间 件 。 稍 等 一 会 儿 , 我们 马上 就 会 谈 到 错误 处 理 中 间 件 。 现 在 你 

只 要 知道 ， 它 告诉 Connect 你 的 中 间 件 结束 了 ， 并 且 在 它 的 执行 过 程 中 出 现 了 一 个 错误 。 

在 认证 正常 完成 (未 出 现 错误 ) 后 ，Connect 会 继续 执行 下 一 个 中 间 件 组 件 ， 也 就 是 本 例 中 
的 adqmin。 











6.4.2 ”显示 管理 面板 的 中 间 件 


中 间 件 组 件 adamin 在 请 求 URL 上 用 switch 语 句 做 了 一 个 原始 的 路 由 硕 。 当 用 户 请 求 /时 ， 
aqmin 组 件 会 显示 一 条 转发 消息 ， 请 求 /users 时 ， 它 会 返回 一 个 包含 用 户 名 的 JSON 数 组 。 这 个 
例子 中 的 用 户 名 午 是 与 死 在 代码 里 的 ， 但 在 真实 的 程序 中 ， 用 户 名 应 该 是 从 数据 库 里 取出 来 的 。 


代码 清单 6-7 ”路 由 adqmin 请 求 
functacn adminireg, res, next) { 
switch (reg.urly { 

















Case '/': 
res.end{'try /usSerS '  ) 
break: 

CASE '/USEers': 
res.setHeader('Content-Type', 'application/json').; 
res.end(JSOoN.stringify(['tobi', 'loki', 'jane'])).; 
break: 


】 
} 


这 里 要 注意 的 是 case 中 用 的 是 字符 早 ， 是 /和 /users， 而 不 是 /admin 和 /admin/users。 
这 是 因为 在 调用 中 间 件 之 前 ，Connect 从 zedq.ur1 中 去 掉 了 前 级 ， 驶 像 URL 挂 载 在 /上 一 样 。 这 个 
简单 的 技术 让 程序 和 中 间 件 更 灵活 ， 因 为 它们 不 用 关心 它们 用 在 哪 。 

比如 说 ， 通 过 挂 载 ， 不 用 修改 博客 程序 代码 就 可 以 让 博客 程序 的 URL 从 http:/foo.comy/blog 上 
迁移 到 http://bar.com/posts 上 。 因 为 在 挂 载 后 ，Connect 会 去 掉 req .url 上 的 前 级 部 分 。 最 终结 
是 博客 程序 可 以 用 相对 /的 路 径 编 写 ， 不 需要 知道 是 挂 载 在 /blog 还 是 /posts 上 。 请 求 可 以 用 相同 的 
中 间 件 ,共享 相同 的 状态 。 看 一 下 后 面 这 段 代 人 码 中 的 服务 右 设 置 ， 还 是 那个 假想 的 博客 程序 ,在 



































两 个 不 同 的 挂 载 点 上 挂 载 它 : 
Var Connect = require('connect').; 
connect!{) 


.USe (logger) 
.USe('/blog', blog) 
.USe('/posts', blog) 
.uselhello) 
.listen({3000).， 
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测试 一 下 
中 间 件 都 做 好 了 ， 该 用 cur 测 试 一 下 这 个 程序 了 。 你 可 以 看 到 除了 /admin 的 其 他 常规 URL 都 
能 像 预 期 那样 调用 hel11o 组 件 : 


$s curl http://localhost 
hello world 


$s curl http://localhost/foo 
hello world 


当 用 户 没 有 给 出 认证 信息 , 或 所 用 的 认证 信息 不 正确 时 , 你 还 能 看 到 restrict 组 件 会 返回 错误 : 


$s curl http://localhost/admin/users 
Error: Unauthorized 
at Opject.restrict [as handlel 
(E:\transfer\manning\node.js\src\ch7\multiple connect.js:24:35) 
at next 
(E:\transfer\manning\node.js\src\ch7\node modules\ 
connect\lib\proto.js:190:15) 


$ curl --user Jane:ferret http://localhost/admin/users 
Error: Unauthorized 
at Opject.restrict [as handlel] 
(E:\transfer\manning\node.jJs\src\ch7\multiple connect.jJs:24:35) 
at next 
(E:\transfer\manning\node.js\src\ch7\node modules\ 
connect\l1ib\proto.js:190:15) 


最 后 ,你 会 看 到 只 有 用 "tobi" 用 户 通过 认证 时 ，admin 组 件 才 会 被 调用 ,服务 器 才 会 响应 包含 
用 户 的 JSON 数 组 : 


S$_ CUT] -=-uUSset tobi:ferret http://localhost/admin/users 





[* toy ， ” ] ok1i 和 "jane"l] 


看 到 挂 载 是 多 么 简单 义 是 多 么 强大 了 吗 ? 接 下 来 我 们 看 一 些 创 建 可 配置 中 间 件 的 技术 吧 。 


6.5 创建 可 配置 中 间 件 


你 已 经 学 过 了 一 些 中 间 件 的 基础 知识 , 现在 我 们 要 深入 细 市 , 看 看 如 何 创 建 更 通用 的 、 可 重 
用 的 中 间 件 。 可 重用 是 我 们 编写 中 间 件 的 主要 原因 ,并 且 我 们 会 在 这 一 方 创建 可 以 配置 日 志 、 路 
由 请 求 、URL 每 的 中 间 件 。 你 只 要 额外 做 些 配 置 就 能 在 程序 中 重用 这 些 组 件 ,无需 从 尖 实 现 这 些 
组 件 来 适应 你 的 特定 程序 。 

为 了 向 开发 人 员 提 供 可 配置 的 能 力 , 中间 件 通 党 会 避 循 一 个 简单 的 惯例 : 用 函数 返回 为 一 个 
哨 数 (这 是 一 个 强大 的 JavaScript 特 性 ， 通 第 称 为 团 包 )。 这 种 可 配置 中 间 件 的 基本 结构 看 起 来 
是 这 样 的 : 

function setup(options) { 


/ / 设置 还 辑 _ 在 这 里 做 中 间 件 的 初始 化 















































return function(regq, res, next) { 
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// 中 间 件 逻辑 即使 被 外 部 函数 返回 了 ， 
仍然 可 以 访问 options 
} 
3 


这 种 中 间 件 的 用 法 如 下 : 

app.usel(setupl{some: 'options'})) 

注意 , 在 上 面 的 app.use 中 调用 了 setup 国 数 , 而 在 之 前 的 例子 中 我 们 只 是 传人 函数 的 引用 。 
本 市 会 使 用 这 项 技术 构建 三 个 可 重用 、 可 配置 的 中 间 件 组 件 : 

口 市 有 可 配置 的 数据 格式 的 1ogger 组 件 ; 

口 基于 所 请 求 的 URL 调 用 吨 数 的 zoutez 组 件 ; 

口 将 URE 中 的 一 段 转换 为 了 的 URL rewriter 组 件 。 

接 下 来 我 们 先 扩 展 logger 组 件 ， 让 它 的 可 配置 性 更 强 。 


6.5.1 创建 可 配置 的 logger 中 间 件 组 件 


本 章 前 面 创建 的 那个 Logger 中 间 件 组 件 不 是 可 配置 的 。 它 是 在 代码 里 写 死 了 要 输出 请 求 的 
req.method 和 req.url。 如 果 你 将 来 想 改 变 1ogger 显 示 的 信息 怎么 办 呢 ? 你 可 以 手动 修改 
logger 组 件 , 但 更 好 的 办 法 是 从 一 开始 就 把 logger 做 成 可 配置 的 , 而 不 是 在 代码 里 写 死 。 动手 吧 ! 

在 实际 工作 中 , 可 配置 的 中 间 件 用 起 来 跟 你 之 前 创建 的 中 间 件 用 起 来 是 一 样 的 ,只 是 可 以 回 
其 中 传人 额外 的 参数 来 改变 它 的 行为 。 在 程序 中 使 用 可 配置 组 件 看 起 来 和 下 面 这 个 例子 有 点 像 ， 
logger 能 接收 一 个 字符 串 ， 描 述 它 应 该 输出 的 日 志 格 式 : 

Var app = connect') 


.Usel(logger(':method :url')) 
.USe (hello).; 


实现 可 配置 的 1ogger 组 件 需要 先 定 义 一 个 setup 函 数 ， 它 能 接受 一 个 字符 串 人 参数 (我们 把 
它 命 名 为 format )。setup 被 调用 后 , 会 返回 一 个 孔 数 ， 即 Connect 所 用 的 真正 的 中 间 件 组 件 。 即 
便 被 setup 困 数 返 回 后 ， 这 个 组 件 仍 能 访问 Eormat 变 量 ， 因 为 它 是 在 同一 个 JavaScript 闭 包 内 和 是 
义 的 。 然 后 loggez 会 用 rea 对 象 中 相关 联 的 请 求 属性 蔡 换 format 中 的 标记 , 输出 到 stdout， 调 用 
next () ， 代 码 如 下 所 示 。 


代码 清单 6-8 ”可 配置 的 Connect 中 间 件 组 件 logger 












































function setup(format) { setup 函 数 可 以 用 不 
同 的 配置 调用 多 次 
一 人 > Var regexp = /:(\w+)/g; 
a Connect 使 用 的 真 
则 表达 式 return function logger(req, res, next) { 实 logger 组 件 
六 过 
匹配 请 求 
属性 var str = format.replace (regexp, function(match, property)t 
retirn redlproperty]; 人 | 
ee 请 求 的 日 志 条 和 目 
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console.log(str); < 一 将 日 志 条 目 输出 到 控制 台 
next (); < 一 将 控制 权 交 给 下 一 个 中 间 件 组 件 
} 
} 
module, exports = Setup: < 一 直接 导出 logger 的 setup 了 函数 


因为 我 们 将 这 个 logger 中 间 件 组 件 创建 成 了 可 配置 的 中 间 件 ,你 可 以 用 不 同 的 配置 在 同一 
程序 中 多 次 .use () 这 个 logger， 或 者 在 将 来 开发 的 程序 中 任意 重用 这 个 logger 人 代码。 在 整个 
Connect 社 区 中 都 在 使 用 这 种 简单 的 可 配置 中 间 件 概念 ， 并 且 为 了 保持 一 致 性 ， 所 有 Connect 核 心 
中 间 件 都 在 用 。 

接 下 来 我 们 写 一 个 稍微 有 点 逻辑 的 中 间 件 组 件 。 创 建 一 个 将 请 求 映射 到 业务 逻辑 的 路 由 需 ! 


6.5.2 ”构建 路 由 中 间 件 组 件 


在 Web 程 序 中 ， 路 由 是 个 至 关 重 要 的 概念 。 简 言 之 ， 它 会 把 请 求 URL 映 射 到 实现 业务 逻辑 的 
函数 上 。 路 由 的 实现 方式 多 种 多 样 ， 从 RoR 等 框 桨 上 用 的 那 种 高 度 抽 象 的 控制 项 ， 到 比较 简单 、 
抽象 程度 较 低 、 基 于 HTTP 方 法 和 路 径 的 路 由 ， 比 如 Express 和 Ruby 的 Sinatra 等 框 染 提供 的 路 由 。 

程序 中 的 简单 路 由 融 看 起 来 可 能 像 代 码 清单 6-9 一 样 。 在 这 个 例子 中 ，HTTP 谓 词 和 路 径 被 表 
未 为 一 个 简单 的 对 象 和 一 些 回调 函数 。 其 中 一 些 路 径 中 包含 涡 有 冒号 (:) 前 级 的 标记 ， 代 表 可 
以 接受 用 户 输入 的 路 径 段 ， 跟 /user12 这 样 的 路 径 相 匹配 。 绪 果 是 程序 中 有 一 个 处 理 需 晒 数 的 集 
合 ， 当 有 请 求 方法 和 URL 跟 其 中 定义 的 路 径 相 匹配 时 ， 就 会 调用 对 应 的 处 理 右 水 数 。 


代码 清单 6-9 ”使 用 router 中 间 组 件 












































var connect = require('connect').; 
var router = require('./middleware/router').; 
var POLES = | 路 由 器 组 件 ， 稍 后 定义 
GET: { 
'/users': function(req, res){ 定义 路 由 的 对 象 
res.end('tobi, loki, ferret'); 
上 
'/user/:id': function(req, res, id)t 
res.end('user ' + id); 和 
} 射 ， 并 包含 要 调用 的 回调 函数 
人 
DELETE: { 
'/user/:id': function(reg, res, id)t{ 
res.end{'deleted user ' + id): 
} 
} 
yy 
connect () _ 将 路 由 对 象 传 给 路 由 器 的 setup 函 数 
.USe (router (YOULeS ) ) 


.listen(3000); 
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因为 程序 里 中 间 件 的 数量 没有 限制 , 中 间 件 组 件 使 用 的 次 数 也 没有 限制 , 所 以 在 一 个 程序 中 
有 可 能 会 定义 几 个 路 由 天 。 这 样 可 能 更 有 利于 组 织 。 比 如 你 既 有 跟 用 户 相 关 的 路 由 ， 也 有 跟 管理 
员 相 关 的 路 由 。 则 可 以 把 它们 分 到 不 同 的 模块 文件 中 , 在 路 由 部 组件 中 分 别 引 入 , 代码 如 下 所 示 : 














var Connect = requilire('connect'}).; 
var router = require('./middleware/router').; 
Connectt{) 
.USe (router (require('./routes/user'))) 
.USe (router (require('./routes/admin'}))})) 


.listen{(3000); 


现在 我 们 来 构建 这 个 路 由 需 中 间 件 。 它 要 比 我 们 之 前 做 过 的 那些 中 间 件 更 复杂 , 所 以 我 们 先 
快速 过 一 下 这 个 路 由 带 要 实现 的 逻辑 ， 如 图 6-2 所 示 。 


先 收 到 神 览 器 或 





其 他 HTTP 客 尸 妆 一 一 
发 来 的 HTTP 请 求 收 到 HTTP 请 求 
Connect 程 序 








router 中 间 件 





这 个 re 2 Ob 
~ es 调用 相关 联 
映射 中 吗 ? 的 回调 函数 
Yes 
call next () 循环 凯 历 *outes 
调用 下 一 个 
中 间 件 


routes [能 匹配 上 | _ Yes 
当前 的 *ea.ur1 吗 ? 


2 i < routes.length? 
铺 环 结束 


图 6-2 ”路 由 融 组 件 的 流程 图 


routes 





流程 图 几乎 束 跟 这 个 中 间 件 的 伪 人 码 一 样 ,对 你 实现 路 由 此 的 破 实 代码 很 有 带 助 。 这 个 中 间 件 
的 全 部 代码 都 在 下 面 这 个 清单 中 。 


代码 清单 6-10 ”简单 的 路 由 中 间 件 


Var parse = require('url') .parse; 
module.exports = function route(obj) { 信 查 以 确保 
return Tunetionlredr, res, ext}1? Ue req.method 
if (lobjlregq.method]) { 定义 了 
next (); 如 果 未 定义 ， 调 用 next ()， 
return; 并 停止 一 切 后 续 操 作 
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Var routes = obj[req.method] < 查找 req .method 对 应 的 路 径 
var url = parse (req.url,) 
de var paths = Object, kevys (routes) < 一 将 req .method 对 应 的 路 径 存 放 到 数组 中 
pathname for (var i = 0; i < paths.length; i++) { < 一 遍历 路 径 
匹配 Var path = paths[i]; 
Var fn = routesl[lpath]; 
path = path 
.replace(/\//g, '\\/') 
.replace(/: (\w+)/g, '([^\\/]+)'); 
Var re = new RegExp('^' + path + '$'); 二 构造 正则 表达 式 
Var captures = url.pathname.match (re) 
if (captures) { 
尝试 跟 pathname Var args = [reg, res] .concat (captures.slice(1)); 
匹配 ee 区 
return; 
) 当 有 相 匹 配 的 函数 时 ， 返 回 ， 
} 以 防止 后 续 的 next () 调用 


next ( ) ; 


}; 

用 这 个 路 由 需 做 可 配置 中 间 件 的 例子 再 合适 不 过 了 , 因为 它 符合 传统 的 形式 ， 有 返回 中 间 件 
组 件 供 Connect 程 序 使 用 的 设置 函数。 在 这 个 例子 中 ， 它 只 接受 一 个 参数 ，routes 对 象 ， 其 中 包 
含 HITP 谓 词 、 请 求 URL 和 回调 函数 的 映射 。 它 首先 检查 当前 的 req.methoq 在 routes 有 映射 中 是 
否 有 定义 ， 如 果 没 有 则 停止 进一步 处 理 ( 即 调用 next () )。 之 后 它 会 循环 遍历 已 定义 的 路 径 ， 检 
查 是 否 有 跟 当前 的 reg.ur1l 相 匹配 的 路 径 。 如 果 找 到 匹配 项 ,， 则 调用 匹配 项 的 回调 晒 数 ， 期 望 完 
成 对 HTTP 请 求 的 处 理 。 

这 是 有 两 个 优秀 特性 的 完整 中 间 件 组 件 , 但 你 对 它 进行 扩展 也 很 容易 。 比 如 说 ,你 可 以 利用 
闭 包 的 能 力 在 外 层 孔 数 中 缓存 正则 表达 式 ， 人 免得 在 每 个 请 求 之 前 都 要 重新 编译 一 次 。 

中 间 件 还 有 一 个 很 棱 的 用 处 ,可 以 重 写 URL。 接 下 来 我 们 马上 介绍 一 个 中 间 件 组 件 , 它 可 以 
处 理 URL 中 的 博客 文章 缩 略 名 ， 而 不 要 求 URL 中 是 ID。 


6.5.3 构建 一 个 重 写 URL 的 中 间 件 组 件 


重 写 URL 可 能 非 第 有 用 。 比 如 你 想 接 受 一 个 到 /blog/posts/my-post-title 的 请 求 ， 基 于 这 个 URL 
最 后 的 文章 标题 〈 通 稼 称 为 UREL 的 缩 略 名 部 分 ) 查找 文章 的 ID ， 然 后 将 URL 转 换 成 /blog/ posts/。 
这 个 任务 特别 适合 中 间 件 ! 

下 面 这 个 小 博客 程序 和 完 用 rewrite 中 间 件 组 件 基 于 缩 略 名 重 写 URL, 然后 再 将 控制 权 转 交 给 
showPos t 组 件 


var Connect = regquire('connect') 

















var url = require('url') 
var app = Connect') 
.Use (rewrite) 
.Use {showPost) 
.listen(3000) 
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代码 清单 6-11 是 rewrite 中 间 件 的 实现 ， 对 URL 进 行 解析 ， 得 到 pathname， 人 然后 将 pathname 
跟 正 则 表达 式 匹 配 。 经 过 匹配 得 出 的 第 一 个 结果 ( 缩 略 名 ) 被 传 给 了 假想 的 findqPostIdBySlug 
印 数 ， 让 它 通 过 缩 略 名 找到 博客 文章 的 ID。 如 果 成 功 ， 就 按 你 的 想法 给 请 求 URL ( req.url ) 重 
新 赋值 。 在 这 个 例子 中 是 把 ID 追加 到 /blog/post 上 ， 以 便 后 续 的 中 间 件 能 通过 ID 查找 文章 。 


代码 清单 6-11 ”基于 缩 略 名 重 写 请 求 UREL 的 中 间 件 


var path = url.parse(req.url) .pathname; 








function rewrite(req, res, next) { 








Var match = path.match(/^\/blog\/posts\/(.+)/) 如 果 查 找 出 错 ， 则 通 
> if (match) ({ 知 错误 处 理 器 并 停止 

只 针对 /blog findPostIdBySlug (match[1], function(err, id) { 处 理 

/posts 请 求 if (err) return next (err); 
行 查 拷 if. (Ld) Teturn next (new Error("Vser nor oung™"y])y a 和 
oi regq.url = '/blog/posts/' + id; es 如 果 没 找到 跟 缩 
next ( ) ; 重 写 req.url 属 性 ， 略 名 相对 应 的 
js 以 便 后 续 中 间 件 可 ID, 则 市 着 “User 
} else 1{ 以 使 用 真实 的 ID not found” 的 错 
next ():; 误 参 数 调 用 
Dext () 


】 


这 些 例 子 说 明了 什么 ”这些 例子 传达 了 一 个 重要 信息 ， 在 构建 中 间 件 时 ， 你 应 该 
关注 那些 小 型 的 、 可 配置 的 部 分 。 构 建 大 量 微小 的 、 模 块 化 的 、 可 重用 的 中 间 件 组 件 ， 
合 起 来 搭 成 你 的 程序 。 保 持 中 间 件 的 小 型 化 和 专注 性 真 的 有 助 于 将 复杂 的 程序 膛 辑 分 解 
成 更 小 的 组 成 部 分 。 

接 下 来 我 们 要 看 Connect 中 与 中 间 件 相关 的 最 后 一 个 概念 : 处 理 程 序 错误 。 


6.6 ”使 用 错误 处 理 中 间 件 


所 有 程序 都 有 错误 , 不 管 在 系统 层面 还 是 在 用 户 层 面 。 为 错误 状况 ,甚至 是 那些 你 没 预料 到 
的 错误 状况 而 未 雨 绸 弓 是 明知 之 举 。Connect 按 照常 规 中 间 件 所 用 的 规则 实现 了 一 种 用 来 处 理 错 
误 的 中 间 件 变 体 ， 除 了 请 求 和 响应 对 象 ， 还 接受 一 个 错误 对 象 作为 参数 。 

Connect 刻 意 将 错误 处 理 做 到 最 简 ， 让 开发 人 员 指 明 应 该 如 何 处 理 错 误 。 比 如 说 ， 你 可 以 只 
让 系统 和 程序 级 错误 ( 比如 “变量 foo 是 undefined 的 ”) 通过 中 间 件 , 或 者 用 户 钳 误 (“密码 无 效 ”)， 
或 者 两 者 的 组 合 。Connect 让 你 目 己 选择 最 佳 的 处 理 琳 上 略 。 

本 市 中 两 种 方式 都 会 用 到 , 并 且 你 能 了 解 到 错误 处 理 中 间 件 是 如 何 工 作 的 。 在 看 下 面 这 些 内 
容 时 ， 你 还 能 学 到 一 些 实用 的 模式 : 

口 使 用 Connect 默 认 的 错误 处 理 需 ; 

口 自己 处 理 程序 错误 ; 

口 使 用 多 个 错误 处 理 中 间 件 组 件 。 

我 们 先 从 没有 任何 配置 的 Connect 销 误 处 理 开 始 。 



































图 灵 社区 会 员 quqingtao 专 享 尊重 版 权 





124 第 6 章 “Connect 


6.6.1 Connect 的 默认 错误 处 理 器 
看 一 下 下 面 这 个 中 间 件 组 件 ， 因 为 限 数 foo0 没 有 定义 ， 所 以 它 会 抛 出 错误 ReferenceError: 


var connect = require('connect') 





connect{) 
.USel(function hellotreq, res) ({ 
foo(); 
res.setHeader('Content-Type', 'text/plain'); 
res.end{'hello world')}); 
a 
.listen(3000) 


默认 情况 下 ，Connect 给 出 的 啊 应 是 状态 码 5300， 包含 文本 “Internal Server Error” 以 及 错误 月 
和 刁 详 细 信 息 的 啊 应 主体 。 这 很 好 , 但 在 任何 实际 的 程序 中 ,你 很 可 能 都 会 对 那些 错误 做 些 特殊 的 
处 理 ， 比 如 将 它们 发 送 给 一 个 日 志 守 护 进程 。 


6.6.2 目 行 处 理 程序 错误 


在 Connect 中 ， 你 还 可 以 用 错误 处 理 中 间 件 自行 处 理 程序 错误 。 比 如 说 ， 在 开发 时 你 可 能 想 
用 JSON 格 式 把 错误 发 送 到 客户 新， 做 简单 快捷 的 错误 报告 ， 而 在 生产 环境 中 ， 你 可 能 只 想 啊 应 
一 个 简单 的 “服务 带 错 误 ”， 以 人 免 把 敏感 的 内 部 信息 ( 比如 堆栈 跟踪 ， 文 件 名 和 行 写 等 ) 暴露 给 
潜在 的 攻击 者 。 

错误 处 理 中 间 件 印 数 必须 接受 四 个 参数 : err、req、res 和 next， 如 下 面 的 代码 清单 所 示 ， 
而 常规 的 中 间 件 只 有 三 个 参数 : req、res 和 和 next。 


代码 清单 6-12 ”Connect 中 的 错误 处 理 中 间 件 











function errorHandler() { 错误 处 理 中 间 件 定 
Var env = process.env.NODE_ENV | | 'development'; 义 四 个 参数 
return function(err, req, res, next) I 
res.statusCode = 500;，; 
switch (env) { 
case 'development': errorHandler 中 间 件 组 
res, SetHeader ("Content-Type', application/json'd):; 件 根 据 NOoDE_ENV 的 值 
res.end(JSON.stringify (err)); 执行 不 同 的 操作 
break; 
default: 


res.end('Server error ' ) ; 


用 NoDE _ENV 设 定 程序 的 模式 Connect 通常 是 用 环境 变量 NODE_ENV (process. 
env.NODE_ENV ) 在 不 同 的 服务 器 环境 之 间 切 换 ， 比 如 生产 和 开发 环境 。 


当 Connect 遇 到 错误 时 ， 它 只 调用 错误 处 理 中 间 件 ， 如 图 6-3 所 示 。 
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A Connect application 
总 that does error handling 


HTTP GET request 
/bad-url 


HTTP 客 户 端 
(Wep 浏 览 器 ) 





全) 会 抛 出 错误 的 HTTP 请 求 。 

@? 像 往 芝 一 样 把 请 求 在 中 间 件 栈 上 内 下 传递 。 

3 啊 哦 ! router 中 间 件 报错 了 | 

@ 中 间 件 hello 被 跳 过 去 了 ， 因 为 它 不 是 错误 处 理 中间 件 。 


中 间 件 errorHandler 得 到 了 中 间 件 logger 创 建 的 Error， 
并 能 在 Error 的 上 下 文中 啊 应 请 求 。 


图 6-3 ”在 Connect 服 务 器 中 引发 错误 的 HTTP 请 求 的 生命 周期 做 错误 处 理 的 Connect 程 序 
比如 在 前 面 那个 管理 程序 中 , 如 条 给 用 户 路 由 的 路 由 中 间 件 组 件 出 现 了 错误 , blog 和 admin 
中 间 件 组 件 都 会 被 跳 过 去 ， 因 为 从 它们 的 表现 来 看 都 不 是 错误 处 理 中 间 件 ， 只 定义 了 三 个 参数 。 
然后 Connect 看 到 接受 错误 参数 的 errorHandler， 就 会 调用 它 : 

















Connect() 
.USe(router(regquire('./routes/user'))) 
.USe(router (regquire({',/routes/blog')}) // 跳 过 
.USe{router (require{('./routes/aqdmin'))) // 跳 过 
.USe (errorHandler'()).， 


6.6.3 ”使 用 多 个 错误 处 理 中 间 件 组 件 


用 中 间 件 的 变 体 做 错误 处 理 对 于 将 错误 处 理 问题 分 离 出 来 很 有 帮助 。 假 定 你 的 程序 在 /api 上 
提供 了 一 项 Web 服 务 。 你 可 能 想 在 碰 到 程序 错误 时 演 染 一 个 HTML 错 误 页 面 给 用 户 , 但 /api 返 回 更 
详细 的 错误 信息 ， 可 能 总 是 JSON 格 式 的 ， 这 样 收 到 错误 信息 的 客户 闻 就 很 容易 解析 错误 ， 并 作 
出 恰当 的 应 对 。 
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为 了 了 了解 这 个 /api 场 景 的 工作 机 制 ， 请 你 边 看 边 完 成 这 个 小 例子 。 下 面 的 app 是 Web 主 程序 ， 
api 挂 载 在 /api 上 : 


Var abl = connect!) 
.US 人 TUSGTS | 
.USe (pets) 
.USe (errorHandler); 


var app = connect') 
.uselhello) 
.USe('/api', api) 
.USeE (errorPage) 
.listen({3000).， 


我 们 把 这 个 配置 在 图 6-4 中 男 出 来 了 。 


程序 
app 
中 国 件 
hello 
程序 
apl 
HTTP 请 求 沿 着 、 
中 中 国体 
USers 
中 间 件 
pets 
普 误 处 理 
中 间 件 
errorHandler 
错误 处 理 
中 间 件 
SIrrorPage 


图 6-4 ”和 带 有 两 个 错误 处 理 中 间 件 组 件 的 程序 布局 


现在 需要 你 实现 程序 中 的 所 有 中 间 件 组 件 : 

口 nello 组 件 会 给 出 啊 应 “Hello World\n.”:; 

口 如 果 用 户 不 存在 ，users 组 件 会 抛 出 一 个 hotFoundError; 

加 | 为 了 演示 错误 处 理 融 ， pets 会 引发 一 个 要 抛 出 的 ReferenceError; 
D srrorHandler 组 件 会 处 理 来 目 api 的 所 有 错误 ; 

加 errorPage 主 机 会 处 理 来 目 主 程序 app 的 所 有 错误 。 

1. 实现 hello 中 间 件 组 件 
hello 组 件 只 是 个 用 正则 表达 式 匹 配 "/nello" 的 图 数 ， 代 码 如 下 所 示 : 


function hellotregq, res, next) { 
if {regq.url.match(/^\hello/}}) { 
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res.end{({'Hello World\n'}: 
} else { 
next ():; 
} 
} 


在 这 么 人 简单 的 函数 中 根本 不 可 能 出 现 错 误 。 

2. 实现 users 中 间 件 组 件 

users 组 件 稍微 复杂 点 儿 。 如 代码 清单 6-13 所 示 ， 你 用 正则 表达 式 匹 配 r*eq.url， 然 后 用 
match[1] 检 查 用 户 索 引 是 否 存在 ， 它 是 你 的 匹配 捕获 的 第 一 组 数据 。 如 果 用 户 存 在 ， 则 被 串 行 
ws 否则 将 一 个 错误 对 象 的 notFound 属 性 设置 为 true， 传 给 next () 隐 数 ， 以 便 在 后 续 


的 错误 处 理 组 件 中 可 以 统一 错误 处 理 逻 辑 。 
代码 清单 6-13 ”在 数据 库 中 搜索 用 户 的 组 件 














var db = 1 
users: | 

{ name: 'tobi' }, 

{ name: 'J]oki' }, 

{ name: 'Jane' } 


] 
}; 


function users(req, res, next) { 
var match = regq.url.match(/^\/user\/(.+}/) 
if (match) { 
Var user = qQb.users [match[111]:; 
if (user) 1{ 











res.setHeader('Content-Type', 'application/json'}): 
res.end(JSON.stringify (user)).;， 

} else 1 
Var err = new Error('User not found'}):; 
err.notFound = true; 
next (err),; 

} 

} else 1{ 
next().: 


} 
} 


3. 实现 pets 中 国 件 组 件 

下 面 的 代码 片段 给 出 了 一 个 特定 的 pets 组 件 实现 。 我 们 用 它 来 前 明 如 何在 错误 上 应 用 处 理 
逻辑 ， 比 如 根据 在 users 组 件 中 设 定 的 布尔 型 srr .notFound 之 类 的 属性 。 下 面 代码 中 未 定义 的 
foo () 滑 数 也 会 触发 异常 ， 但 它 不 会 有 err .notFound 属 性 。 


function petslredq, res, next) 1{ 
if (regq.url.match(/^\/pet\/(.+)}/})) { 
上 人 
} 所 1Se 1 
next().: 
} 
} 
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4. 实现 errorHandler 中 国 件 组 件 

终于 到 了 实现 srrorHandler 组 件 的 时 候 了 ! 对 于 Web 服 务 来 说 ， 计 有 上 下 文 信息 的 错误 消 
息 特 别 重 要 ， 这 样 Web 服 务 可 以 给 消费 者 提供 恰当 的 反馈 ， 而 又 不 会 骏 露 过 多 信息 。 你 肯定 不 想 
让 用 户 看 到 "{"error":"foo is not defined"}" 之 类 的 错误 信息 ， 或 者 更 糟糕 的 完整 堆栈 
跟踪 信息 ， 因 为 攻击 者 可 能 会 利用 这 些 信 息 对 你 发 起 攻击 。 你 只 能 用 安全 的 错误 消息 作为 反馈 ， 
就 像 下 面 这 个 errorHandler 做 的 那样 。 


代码 清单 6-14 不 暴露 非 必要 数据 的 错误 处 理 组 件 


function errorHandlerlerr, reg, res, next) 1 














console.error{terr.stack); 
res.setHeader('Content-Type', ‘application/json').: 
if {err.notFound) f{ 

res.statusCode = 404: 

res.end{(JSON.stringijfy{{ error: err.message })); 





} else 1 
res.statusCode = S500; 
res.end(JSoON,.stringify({ error: 'JInternal Server Frror' })).，: 





} 
) 


这 个 错误 处 理 组 件 用 前 面 设 定 的 err .notFound 属 性 来 区 分 服务 兹 错误 和 客户 问 错 误 。 男 外 一 种 
方式 是 检查 错误 是 不 是 instanceof 某 种 其 他 错误 ( 比如 某 些 校 验 模块 中 的 ValiqdationError )， 并 
作出 相应 的 响应 。 

使 用 err .notFound 属 性 ， 如 果 服 务 需 接受 的 一 个 HTTP 请 求 ， 比 如 说 /userronald， 并 不 在 你 
的 数据 库 中 users 组 件 会 抛 出 一 个 notFEound 错 误 当 它 到 达 errorHandl er 组 件 中 时 ， 区 2 
触发 srr .notFounqd 这 条 处 理 流 程 , 返回 404 状 态 码 ， 和 市 有 err .message 属 性 的 JSON 对 象 。 图 
6-5 给 出 了 它 在 浏览 带 中 原始 输出 的 样子 。 




















Mozilla Firefox 





| 个 http://local...user/ronald | 十 


< localhost 


{ "error": "User not found"” } 


图 6-$ ”JSON 对 象 输出 “User not found” 错 误 


5. 实现 errorPage 中 间 件 组 件 

erzorPage 组 件 是 这 个 例子 中 的 第 二 个 错误 处 理 组 件 。 因 为 前 一 个 错误 处 理 组 件 从 来 没 调用 
过 next (err) ， 所 以 这 个 组 件 只 有 在 hel1o 组 件 中 出 现 错误 时 才 会 被 调用 。 

那个 组 件 是 最 不 可 能 出 现 错误 的 , 因此 这 个 errorPage 被 调用 的 几率 也 很 小 。 所 以 我 们 把 实 
现 这 第 二 个 错误 处 理 组 件 的 任务 交 给 你 了 ， 因 为 它 对 这 个 例子 来 说 确实 可 有 可 无 。 
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程序 终于 准备 好 了 。 你 可 以 局 动 服务 锅 ,我们 在 最 开始 时 设 定 让 它 监 听 3000 端 口 。 你 可 以 用 
浏览 器 或 curl 或 其 他 任何 HTTP 客 户 端 试 一 试 。 请 求 无 效 的 用 户 ， 或 请 求 pets 记 录 来 激发 错误 处 
理 硕 的 各 种 处 理 路 由 。 

再 强调 一 次 , 错误 处 理 对 任何 程序 来 说 都 是 至 关 重 要 的 。 用 错误 处 理 中 间 件 组 件 可 以 把 程序 
中 的 错误 处 理 逻 辑 统 一 起 来 集中 到 一 起 。 在 把 程序 放 到 生产 环境 中 时 , 里 面 至 少 应 该 有 一 个 错误 
处 理 中 间 件 。 











6.7 小结 


对 于 这 个 精干 的 Connect 框 架 ， 你 需要 学 习 的 知识 在 本 草 中 都 已 经 讲 到 了 。 你 学 过 了 分 派 还 
如 何 工 作 ， 如 何 构 建 中 间 件 让 程序 更 加 模块 化 、 更 加 灵活 。 你 学 过 了 如 何 将 中 间 件 挂 载 到 特定 的 
根 URL 下 ， 从 而 在 程序 内 创建 程序 。 你 还 接触 到 了 可 配置 的 中 间 件 ， 可 以 接受 设 定 参 数 ， 从 而 根 
据 不 同 的 用 途 进 行 调 整 。 最 后 你 又 学 到 了 如 何在 中 间 件 中 处 理 错误 。 

基础 已 经 打 好 也 ， 该 学 学 Connect 自 带 的 中 间 件 了 。 我 们 下 一 革 就 讲 这 个 。 
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Connect 目 市 的 中 国 件 





本 章 内 容 

口 解析 cookie、 请 求 主 体 和 碍 询 字 符 串 的 中 间 件 
口 实现 Web 程 序 核心 功能 的 中 间 件 

口 处 理 Web 程 序 安 全 的 中 间 件 

口 提供 毅 态 文件 服务 的 中 间 件 














在 上 一 章 里 ,你 已 经 学 过 中 间 件 是 什么 了 ， 也 学 过 如 何 创建 中 间 件 ， 以 及 在 Connect 中 如 何 
使 用 它们 了 。 但 Connect 真 正 蝇 大 之 处 在 于 它 自 带 的 中 间 件 , 它们 可 以 满足 常见 的 Web 程 序 开发 需 
求 ， 比 如 会 话 管理 、cookie 解 析 、 请 求 主 体 解 析 、 请 求 日 志 等 。 这 些 复 杂 程 度 各 异 的 中 间 件 为 构 
建 简 单 的 Web 程 序 或 更 高 层 的 Web 框 架 提 供 了 绝 佳 的 起 点 。 

本 草 通 篇 都 在 解释 和 阐述 这 些 凋 用 的 目 市 中 间 件 组 件 。 表 7-1 中 是 我 们 将 要 讨论 的 中 间 件 的 
汇总 。 

我 们 首先 会 讨论 构建 恰当 的 Web 程 序 所 需 的 各 种 解析 器 中 间 件 ， 因 为 它们 是 大 多 数 中 间 件 的 
基础 。 























表 7-1 Connect 中 间 件 快速 参考 指南 

















中 间 件 组 件 章节 介 绍 
cookiePparser () Tl 为 后 续 中 间 件 提供 req .cookies 和 req.signedCookies 
bodyParser () 7.1.2 为 后 续 中 间 件 提供 rea.bodqvy 和 req.files 
Timit() Tl 基于 给 定 字 市 长 度 限制 请 求 主体 的 大 小 。 必 须 用 在 bodyParser 中 间 件 之 前 
query () 7.1.4 为 后 续 中 间 件 提供 req .query 
logger () 92 将 HTTP 请 求 的 信息 输出 到 stdout 或 日 志文 件 之 类 的 流 中 
favicon() 7.2.2 啊 应 /favicon.ico HTTP 请 求 。 通常 放 在 中 间 件 logger 前 面 , 这 样 它 就 不 会 出 现在 

你 的 日 志文 件 中 了 

methodoverride () 了 .2.3 可 以 奉 不 能 使 用 正确 请 求 方法 的 浏览 需 仿 造 rea.method， 依 赖 于 bodqyParser 
vhost () T2224 根据 指定 的 主机 名 ( 比如 nodejs.org ) 使 用 给 定 的 中 间 件 和 /或 HTTP 服务 融 实 例 
session() 72.5 为 用 户 设 置 一 个 HTTP 会 话 ， 并 提供 一 个 可 以 跨越 请 求 的 持久 化 req .session 对 


象 。 依赖 于 cookiePars er 
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( 续 ) 
中 间 件 组 件 章节 介 绍 
basicAuth () 7.3.1 为 程序 提供 HTTP 基 本 认证 
csrf() 7.3.2 防止 HTTP 表 单 中 的 跨 站 请 求 伪 造 攻击 ， 依 赖 于 session 
errorHand ler() Te 当 出 现 错误 时 把 堆栈 跟踪 信息 返回 给 客户 端 。 在 开发 时 很 实用 , 不 过 不 要 用 在 生产 
环境 中 
StatLiel) Th] 把 指定 目录 中 的 文件 发 给 HTTP 客 户 端 。 跟 Connect 的 挂 载 功 能 配合 得 很 好 
compress () 7.4.2 用 gzip 压 缩 优 化 HITP 啊 应 
qirectory () 7.4.3 为 HITP 客 户 端 提 供 目录 清单 服务 ， 基 于 客户 端的 Accept 请 求 头 〈 普 通 文本 ，JSON 


或 HTML ) 提供 经 过 优化 的 结 


7.1 解析 cookie、 请 求 主 体 和 查询 字符 串 的 中 间 件 


Node 中 没有 解析 cookie、 组 人 存 请 求 体 、 解 析 复 杂 查 询 字 符 串 之 类 高 层 Web 程 序 概念 的 核心 模 
块 ， 所 以 Connect 为 你 提供 了 实现 这 些 功 能 的 中 间 件 。 本 节 会 讨论 四 个 解析 请 求 数据 的 目 齐 中间 
件 组 件 : 

DD cookieParser () 解析 来 日 浏览 人 的 cookie， 放 到 req .cookies 中 :; 

口 podyParser () ” 读 取 并 解析 请 求 体 ， 放 到 req .body 中 ; 

口 limit() 跟 pboqyParsezr () 联 手 防 止 谈 取 过 大 的 请 求 ; 

D auery() ”解析 请 求 URL 的 查询 字符 串 ， 放 到 req .query 中 。 

我 们 先 从 cookie 开 始 ， 因 为 HTTP 是 无 状态 协议 ， 所 以 浏览 帮 经 党 用 它 模拟 状态 。 


7.1.1 cookieParser(): 解析 HTTP cookie 


Connect 的 cookie 解 析 吉 支持 常规 cookie 、 签 名 cookie 和 特殊 的 JSON cookie。tred.cookies 默 
认 是 用 常规 未 签名 cookie 组 装 而 成 的 。 如 果 你 想 支持 session () 中 间 件 要 求 的 签名 cookie， 在 创 
建 cookieParser () 实例 时 要 传 入 一 个 加 密 用 的 字符 串 。 


在 服务 器 端 设 定 cookie 中 间 件 cookieParser() 不 会 为 设 定 出 站 cookie 提 供 任 何 

灾 助 。 为 此 你 应 该 用 res .setHeader () 函数 设 定 名 为 Set-Cookie 的 响应 头 。Connect 

针对 Set-Cookie 响 应 头 这 一 特殊 情况 为 Node 默 认 的 res.setHeaqder () 函数 打 了 补 

可， 所 以 它 可 以 按 你 期 望 的 方式 工作 。 

1. 基本 用 法 

作为 参数 传 给 cookieParser () 的 秘 钥 用 来 对 cookie 签 名 和 解 签 ， 让 Connect 可 以 确定 cookie 
的 内 容 是 否 被 算 改 过 ( 因为 只有 你 的 程序 才 知 道 秘 钥 的 值 )。 这 个 秘 钥 通 常 应 该 是 个 长 度 合理 的 
字符 串 ， 有 可 能 是 随机 生成 的 。 

下 例 中 的 秘 钥 是 tobi is a cool ferret: 
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Var Connect = requirel('connect'); 
var app = Connect + 】 
.USe (connect.cookieParser{'tobl is a cool ferret')})) 





.usSe(function(reg, res)t 
console.logl(req.cookies),; 
console,.log (regq.signedCookies).: 
res.end{'hello\n').; 

}}.listen{({3000); 


设 定 在 reg. cookies 和 和 redqd. signedCookies 属 性 上 的 对 象 是 随 请 求 发 送 过 来 的 请 求 头 
Cookie 的 解析 结果 。 如 果 请 求 中 没有 cookie， 这 两 个 对 象 都 是 空 的 。 

2. 常规 cookie 

如 果 你 用 curl (1) 癌 前 面 那 个 服务 妖 发 送 不 囊 cookie 请 求 涉 字 段 的 HTTP 请 求 ， 两 个 
console.1og() 调 用 输出 的 都 是 空 对 象 


$s curl http://localhost:3000/ 
{} 
{} 


现在 试 着 发 送 一 些 cookie， 你 会 看 到 这 两 个 cookie 都 是 reqg .cookies 的 属性 . 

$s Curl http://localhost:3000/ -H "Cookie: foo=bar, bar=baz" 

{ foo: 'bar’', bar: 'baz' } 

{} 

3. 签名 cookie 

签名 cookie 更 适合 敏感 数据 ， 因 为 用 它 可 以 验证 cookie 数 据 的 完整 性 ， 有 助 于 防止 中 间 人 攻 
击 。 有 效 的 签名 cookie 放 在 regq.signedcookies 对 象 中 。 把 两 个 对 象 分 开 是 为 了 体现 开发 者 的 
意图 。 如 果 把 签名 的 和 未 签名 的 cookie 放 到 同一 个 对 和 象 中 ， 常 规 cookie 可 能 就 会 锌 改造， 仿冒 签 
名 的 cookie。 

签名 cookie 看 起 来 像 tobi .DDm3AcVxE9oneYnbmpdxovhyKsk 一 样 , 点 号 (. ) 左 边 的 是 cookie 
的 值 ， 右 边 是 在 服务 硕 上 用 SHA-1 HMAC 生 成 的 加 密 哈 硕 值 〈 基 于 哈 布 的 消息 认证 人 码 )。 如 果 
cookie 的 值 或 者 HMAC 被 改变 的 话 ，Connect 的 解 签 会 失败 。 

假设 你 设 定 了 一 个 键 为 name ， 值 为 luna 的 签名 cookie。cookieParser 会 将 cookie 编 码 为 
luna .POLMOWNvqOQEObZXUkWbS5m6Wlg。 每 个 请 求 中 的 哈 希 值 都 会 检查 ， 如 果 cookie 完 好 无 损 
地 传 上 来 ， 它 会 被 解析 为 reg .signedCookies .name: 


$ curl http://localhost:3000/ -H "Cookie: 
name=J una.PQOLMOWNVcOQEOPZXUKWPS5m6WJTLG" 

{} 

{ name: 'luna' } 

GET / 200 4ms 


如 果 cookie 的 值 变 了 ， 俐 下 一 个 cur1 命 令 那 样 ，cookie name 会 被 解析 为 reqg .cookies .name， 
因为 它 是 无 效 的 。 但 仍 可 用 来 调试 或 满足 程序 的 特定 需要 : 
S curl http://localhost:3000/ -H "Cookie: 
name=manny.PQOLMOwWNvdOQEObPZXUKWpbS5m6W]d" 


{ name: 'manny .POLMOwWNVIqOOEOPZXUkWPSSm6WJg' } 


{} 
GET / 200 lms 
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4. JSON cookie 

特别 的 JSON cookie 带 有 前 级 j : ， 告 诉 Connect 它 是 一 个 串 行 化 的 JSON。 JSON cookie 既 可 以 
是 签名 的 ， 也 可 以 是 未 签名 的 。 

Express 之 类 的 框 染 可 以 用 这 个 功能 给 开发 人 员 提 供 更 直观 的 cookie 接 口 ， 而 不 是 让 他 们 手工 
做 JSON cookie 值 的 串 行 化 和 解析 工作 。 下 面 是 Connect 解 析 JSON cookie 的 例子 : 


$s curl http://localhost:3000/ -H 'Cookie: foo=bar, 
bar=j:{"foo":"bar" yy}! 

{ foo: 'lbar', bar: { foo: 'bar' } } 

{} 

GET / 200 lims 


就 像 前 面 提 到 的 ，JSON cookie 也 可 以 是 签名 的 ， 比 如 像 下 面 这 个 请 求 中 这 样 的 : 

$ curl http://localhost:3000/ -H "Cookie: 
cart=j:{\"items\":[1]}.sDS5SPpP6xXFFBO/4ketAl1OP43bcjS3Y" 

{} 


{ cart: { items: [ 1 ] } } 
GET / 200 lms 








5. 设 定 出 站 cookie 

我 们 之 前 提 到 过 ，cookieParser () 中 间 件 没有 提供 任何 通过 set-cookie 啊 应 头 回 HITP 客 户 
器 写 出 站 cookie 的 功能 。 但 Connect 可 以 通过 res .setHeader () 困 数 写 和 人 多 个 Set-cookie 啊 应 头 。 

假定 你 想 设 定 一 个 名 为 fcoo， 值 为 字符 串 bar 的 cookie。 调 用 res.setHeader(), Connect 了/ 


让 你 用 一 行 代码 搞定 。 你 还 可 以 设 定 cookie 的 各 种 选项 ， 比 如 有 效 期 ， 像 这 里 的 第 二 个 
setHeader () 一 样 : 





var Connect = require('connect')}).; 


var app = connect!{) 
.Usel(function(req, res})t 





res.setHeader('Set-Cookie', 'foo=bar'}); 
res.setHeader('Set-Cookie', 'tobi=ferret; 
Expires=Tue, 08 Jun 2021 10:18:14 GMT'); 
res.end().; 


}) .listen(3000); 
如 果 你 用 curl 的 --heaq 标 记 检 查 这 个 服务 融 对 HTTP 请 求 的 啊 应 ， 应 该 能 看 到 你 预期 中 的 
Set-Ccookie 啊 应 头 : 


$s curl http://localhost:3000/ --head 

HITTP/1.1 200 OFK 

Set-Cookie: foo=bar 

Set-Cookie: tobi=ferret; Expires=Tue, 08 Jun 2021 10:18:14 GMT 
Connection: keep-alive 


在 HTTP 啊 应 中 发 送 cookie 的 知识 全 在 这 里 了 。 你 可 以 在 cookie 中 存放 任意 类 型 的 文本 数据 ， 
但 通常 是 在 客户 端 存 放 一 个 会 话 cookie， 这 样 你 就 能 在 服务 器 端 保留 完整 的 用 户 状态 。 这 项 会 话 
技术 封装 在 session () 中 间 件 中 ， 本 音 稍 后 就 会 介绍 。 

在 Web 程 序 开发 中 ， 男 一 个 极其 常见 的 需求 是 解析 入 站 请 求 主体 。 接 下 来 我 们 会 学 习 
bodyParser () 中间 件 ， 以 及 它 如 何 让 你 的 Node 开 发 生涯 变 得 更 加 轻松 。 
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7.1.2 bodyParser(): 解析 请 求 主体 


所 有 Web 程 序 都 需要 接受 用 户 的 输入 。 假 设 你 要 用 HTML 标 签 <input type="file"> 接 受 
用 户 上 传 的 文件 。 用 一 行 代码 添加 bodyParser () 中 间 件 就 全 齐 了 。 这 是 个 非常 有 用 的 组 件 ， 实 
际 上 它 整 合 了 其 他 三 个 更 小 的 组 件 : json(),urlencoded(), 和 multipart()。 

boqyParsezr() 组 件 为 你 提供 了 rea.boqvy 必 性， 可 以 用 来 解析 JSON 、x-www-form-urlencoded 
和 multipart/ form-data 请 求 o 如 果 是 multipart/ form-data 请 求 ， 比 如 文件 上 传 则 还 有 
req.files 对 象 。 

1. 基本 用 法 

假设 你 想 通 过 JSON 请 求 接受 注册 信息 ， 你 要 做 的 只 是 把 podqyParser () 组 件 放 在 所 有 会 访 
问 reqg .body 对 和 象 的 中 间 件 前 面 。 此 外 ， 你 还 可 以 传人 一 个 可 选 的 选项 对 和 象 ， 它 会 被 传 到 前 面 提 
到 的 子 组 件 中 (json()、urlencoded() 和 multipart()): 


var app = connect') 
.UsSe (connect.bodyprarser!(})) 
.USelfunction(req, res)}t 
// .. 注 册 用 户 .. 
res.end('Registered new user: ' + regq.body.username):; 


上 
2. 解析 JSON 数 所 
下 面 这 个 cur1(1) 请 求 可 以 用 来 癌 你 的 程序 提交 数据 ,发 送 一 个 属性 username 设 定 为 tobi 
的 JSON 对 象 


$ curl -qd '{"username":"tobi"}' -H "Content-Type: application/json" 
http://localhost 
Registered new user: tobi 


3. 解析 常规 的 <FORM> 数 据 

为 bodyParsez () 是 根据 content-Type 解 析 数 据 的 ， 输 入 形式 是 抽象 的 ， 所 以 你 的 程序 
只 需 关 心 req .body 数 据 对 象 的 结 

比如 下 面 这 条 curl (1) 命令 , 它 发 送 的 是 x-www-form-urlencoded 数 据 , 但 代码 无 需 任何 
改变 就 能 按 你 的 预期 工作 。 会 跟 之 前 一 样 提 供 req .body .name 属 性 : 


S curl -dd name=tobi http://localhost 
Registered new user: tobi 























4. 解析 MULTIPART <FORM> 数 据 

bodyParser 人 解析 multipart/form-data 数 据 ， 一 般 是 为 了 文件 上 传 。 它 的 底层 处 理 是 由 
第 三 方 模块 formidable 完 成 的 ， 我 们 之 前 在 第 4 章 介绍 过 它 。 

要 测试 这 个 功能 ， 你 可 以 把 rea.boqy 和 red.files 都 输出 到 日 志 中 人 研究 一 下 : 


var app = Conmnect 
.UsSe (connect.bodyparser()) 
.Use(ftunction(regq, res})t{ 
console.log (reg.body)}. 
console.log (req.files}.; 
res.end('thanks!'); 


} 
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现在 你 可 以 用 禹 -F 或 --form 选 项 的 curl (1) 模 拟 浏 览 各 上传 文件 ， 这 个 选项 后 面 应 该 跟着 
输入 域 的 名 称 和 值 。 下面 的 例子 会 上 传 一 个 名 为 photo.png 的 图 片 , 以 及 一 个 值 为 tobi 的 name 域 : 


$ curl -F image=@photo.png -F name=tobi http://localhost 

thanks! 

如 果 你 看 一 下 程序 的 输出 ， 应 该 能 看 到 跟 下 面 的 例子 中 非常 相似 的 内 容 ， 第 一 个 对 象 是 
reG.bodqy， 第 二 个 是 req.files。 从 下 面 的 输出 来 看 ， 你 的 程序 应 该 可 以 得 到 req.files . 
image.path， 并 且 你 还 能 重 命名 硬盘 上 的 文件 ， 把 数据 传 给 工作 线程 进行 处 理 ， 上 传 到 内 容 交 
付 网 络 ， 或 者 做 你 的 程序 需要 的 任何 其 他 事情 : 

{ name: 'tobi' } 

{ image: 

{ Size: 4, 
path: '/tmp/95cd49f7eabb909250abbdo08ea954093',， 
name: 'pPphoto.png’', 
type: 'application/octet-stream', 
lastModifiedDate: Sun, 11 Dec 2011 20:52:20 GMT, 
Jength: [Getter], 
filename: [Getterl], 
mime: [Getter] } } 


看 过 了 主体 解析 器 ， 你 可 能 想 知 道 安全 是 如 何 保证 的 。 如 果 bodyParser () 在 内 存 中 绥 存 
json 和 x-www-form-urlencoded 请 求 主体 ， 产 生 一 个 大 字符 串 ， 那 攻击 者 会 不 会 做 一 个 超级 
大 的 JSON 请 求 主体 对 服务 需 做 拒绝 服务 攻击 呢 ? 答案 基本 上 是 肯定 的 ， 所 以 Connect 提 供 了 
limit() 中 间 件 组 件 。 你 可 以 用 它 指定 可 接受 的 请 求 主体 大 小 。 我 们 去 看 一 看 吧 ! 


7.1.3 Limit(): 请 求 主 体 的 限制 


只 解析 请 求 主体 是 不 够 的 。 开 发 人 员 还 需要 正确 分 类 可 接受 的 请 求 , 并 在 恰当 的 时 机 对 它们 
加 以 限制 。 设 计 1limit () 中 间 件 组 件 的 目的 是 帮助 过 滤 巨 型 的 请 求 ， 不 管 它们 是 不 是 恶意 的 。 

比如 说 ， 一 个 无 心 的 用 户 上 传 照片 时 可 能 不 小 心 发 送 了 一 个 未 经 压缩 的 RAW 图 片 ， 里 面 有 
几 百 兆 的 数据 ， 或 者 一 个 恶意 用 户 可 能 会 创建 一 个 超大 的 JSON 字 符 串 把 bodyParser () 锁 住 ， 
并 最 终 锁 住 V8 的 JSON .parse() 方 法 。 你 必须 把 服务 右 配 置 好 ， 让 它 能 应 对 这 些 状况 。 

1. 为 什么 需要 LIMIT() 

我 们 来 看 一 下 恶意 用 户 如 何 把 一 个 脆弱 的 服务 需 废 掉 。 先 创建 下 面 这 个 名 为 serverjs 的 小 型 
Connect 程 序 ， 它 除了 用 bodyParser () 中 间 件 解析 请 求 主 体外 ， 什 么 也 不 做 : 


Var Connect = require('connect').; 



























































var app = ConmnecCt | 
.USe (connect .bodyParser!()).; 





abpp.listen(3000); 
现在 创建 一 个 名 为 dos.js 的 文件 ， 如 下 面 的 代码 清单 所 示 。 你 会 看 到 恶意 用 户 如 何 用 Node 的 
HTTP 客 户 端 攻击 前 面 那个 Connect 程 序 ， 只 要 写 几 兆 JSON 数 据 就 可 以 了 。 











图 灵 社区 会 员 quqingtao 专 享 尊重 版 权 





136 第 7 章 Connect 自 带 的 中 间 件 


代码 清单 7-1 对 脆弱 的 HTTP 服 务 右 展开 拒绝 服务 攻击 


var http = reguire{(l 'http')},. 


var Ted = http.regquestl{(t 
method: 'POST', 
DOrt: 3000; 


headers: { 告诉 服务 器 你 要 发 送 
'Content-Type': 'application/json,' JSON 数 据 
} 
)) ; 开始 发 送 一 个 超大 


rer. Writel(l[')s 的 数组 对 象 

var n = 300000; 

while (n--) { 
req.write('"foo",'); 

} 


req.write('"bar"]'); 


数组 中 包含 300 000 个 
字符 串 “foo” 


req.end(); 


局 动 服 务 带 ， 运 行 攻击 脚本 : 


S node server.]Js & 
$ node dos.js 


你 将 会 看 到 V8 要 花 10 多 秒 钟 ( 取决 于 你 的 便 件 ) 解析 这 样 大 的 JSON 字 符 串 。 这 很 精 糕 ,但 
好 在 Connect 提 供 了 防止 这 种 状况 出 现 的 Limit() 中 间 件 。 

2. 基本 用 法 

在 bodqyParsezr () 之 前 加 上 1imit() 组 件 ， 你 可 以 指定 请 求 主 体 的 最 大 长 度 ， 既 可 以 是 字 节 
数 ( 比如 1024 )， 也 可 以 用 下 面 任意 一 种 方式 表示 : lgb、25mb 或 50kb。 

如 果 你 将 1imit() 设 定 为 32kb ， 然 后 再 次 运行 服务 硕 和 攻击 脚本 ， 你 会 看 到 Connect 在 请 求 
到 32kb 的 时 候 终止 了 请 求 : 


Var app = Conmnect 人) 
.USe {connect.1imit{'32kb')})) 
.USselconnect .bodqvPEarser () ) 
.use {hello).; 








http.createServer (app) .listen{3000}); 

3. 给 1imit() 更 大 的 灵活 性 

对 接受 用 户 上 传 的 程序 来 说 , 不 能 把 所 有 请 求 主体 的 大 小 都 限制 在 32kb 这 样 小 的 尺寸 , 因为 
大 多 数 上 传 的 图 片 大 小 都 会 超出 这 个 限制 , 并 且 像 视频 之 类 的 文件 肯定 更 是 大 得 多 ,但 对 于 JSON 
或 XML 格 式 的 请 求 主体 来 说 却 是 个 合理 的 尺寸 。 

对 于 需要 接受 多 种 请 求 主体 大 小 的 程序 而 言 , 最 好 将 1imit () 中间 件 组 件 封 狼 在 基于 某 种 配 
置 的 函数 中 。 比 如 将 这 个 组 件 封 装 起 来 指定 Content-Type， 代 码 如 下 所 示 。 


代码 清单 7-2 根据 请 求 的 content-Type 限 制 主体 大 小 


function type(type, fn) { fn 在 这 里 是 个 Limit() 
return functionl(req, res, next)t 实例 
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var ct = req.headers['content-type'] || 


If (0 != ct.indexOf (type)) { 被 返回 的 中 间 件 首先 检 


return next(); 查 content -type 


} 


fn(req, res, next).; 


) | 然后 它 会 调用 传 入 的 1imit 组 件 
} 


、 Var app = Comnmnect ( ) 
处 理 表单， | 


JSON .USe (type('application/x-www-form-urlencoded', connect.1imit('64kb'))) 
.use(type('application/json', connect.1limit('32kb'))) 
.USE (EVDe ("imayger, connect. limit("2mb")y}) < 一 处 理 2M 以 内 的 图 片上 传 
.USe(type('video', connect.1imit('300mb'))) 
.USe (connect.bodyParser () ) | 处 理 300M 以 内 的 视频 上 传 


.use (hello); 
文 个 中 间 件 的 男 一 种 用 法 是 给 bodyParser () 一 个 1imit 选 ， 而 后 者 会 透明 地 调用 1imit () 
我 们 接 下 来 要 讨论 的 中 间 件 组 件 很 小 ， 但 很 实用 ， 0 的 程序 解析 请 求 查 询 字 符 串 的 
组 件 。 











7.1.4 query(): 查询 字符 串 解 析 


你 已 经 学 过 了 boaqyParser () ， 可 以 解析 表单 的 POST 请 求 ， 但 GET 请 求 怎 么 解析 呢 ? 用 
query ( mW 它 解 析 碍 询 字 竹中， 为 程序 提供 reqg .query 对 象 。 对 于 用 过 PHP 的 开发 人 员 而 
言 ， 它 就 跟 $_GET 关 联 数组 类 似 。auery () 跟 podyParser () 一 样 ， 也 要 放 在 其 他 会 用 到 它 的 中 
间 件 前 面 。 

基本 用 法 

下 面 这 个 程序 用 到 了 auery () 中 间 件 ， 它 会 将 请 求 发 送 过 来 的 查询 字符 串 以 JSON 格 式 作为 
响应 返回 去 。 查 询 字 符 串 参数 通 ee ee 


Var app = Connect') 
.UsSe (connect .query!(})) 
.USe(function(regq, res, next)t 
res.setHeader ('Content-Type', 'application/json'); 
res.end(JSON.stringify (req.dquery)); 
bk 


假定 你 要 构建 的 一 个 音乐 库 程 序 提供 了 搜索 引擎 ， 用 查询 字符 中 提交 搜索 参数 ， 比如 
/song-Search?artist=Bob%20Marley&track=Jammin。 3 这 个 查询 会 产生 这 文 样 的 res. Gquery 
对 绷 : 

{ artist: 'Bob Marley', track: 'Jammin' } 

query () 跟 bodyParser() 一 样 都 用 到 了 第 三 方 模块 qs ， 所 以 像 ?images[]=foo.png& 
images[]= bar.png 之 类 的 复杂 查询 会 生成 下 面 这 种 对 象 
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{ lmages: [ 'foo.png', 'bar.png' ] } 

如 果 在 HTTP 请 求 中 没有 查询 字符 串 参 数 ， 比 如 /songSearch，req.query 默 认为 空 对 象 : 

} 

就 是 这 些 了 。 接 下 来 我 们 要 看 看 满足 Web 程 序 核心 需求 的 目 市 中 间 件 ， 比 如 日 志和 会 话 。 


7.2 ”实现 Web 程序 核心 功能 的 中 则 件 


Connect 要 为 大 多 数 稍 见 的 Web 程 序 需求 提供 中 间 件 ,这 样 开 发 人 员 就 不 用 一 次 次 地 重新 实现 
它们 了 。 在 Connect 中 ， 像 日 志 、 会 话 和 虚拟 主机 这 些 Web 程 序 的 核心 功能 都 有 目 刘 的 中 间 件 。 

本 方 会 介绍 5 个 非常 实用 的 中 间 件 ， 你 很 可 能 会 在 目 己 的 程序 中 用 到 它们 : 

口 logger () ”提供 灵活 的 请 求 日 志 ; 

口 favicon() 帮 你 处 理 /favicon.ico 请 求 ; 

UD methodOverride() 让 没有 能 力 的 客户 痪 透明 地 重 写 reqd .Imethoa ; 

口 vhost () 在 一 个 服务 大 上 设置 多 个 网 站 〈 虚拟 主机 ); 

D session() 管理 会 话 数据 。 

之 前 你 创建 过 自己 定制 的 日 志 中 间 件 ,但 Connect 提 供 了 更 灵活 的 解决 方案 
我 们 先 来 了 解 一 下 吧 。 


一 一 



































logger () ， 


7.2.1 logger(): 记录 请 来 


logger () 是 一 个 灵活 的 请 求 日 志 中 间 件 ， 带 有 可 定制 的 日 志 格 式 。 它 还 能 绥 冲 日 志 输 出 ， 
减少 写 硬盘 的 次 数 ， 并 且 如 果 你 想 把 日 志 输 出 到 控制 台 之 外 的 其 他 地 方 ， 比 如 文件 或 socket 中 ， 
还 可 以 指定 日 志 流 。 

1. 基本 用 法 

要 使 用 Connect 的 1ogger () 组 件 , 可 以 像 下 面 这 个 清单 中 这 样 , 调用 因数 让 它 返 回 logger () 
中 间 件 实例 : 


代码 清单 7-3 ”使 用 logger () 中 间 件 


Var Connect = require('connect').; 

















var app = connect() 没有 参数 ， 使 用 默认 的 hello 是 假想 的 中 间 件 ， 返 
-Se (orneet., Logger()) logger 选 项 回 “Hello World” 响 应 
.use (hello) 


.listen(3000).， 
logger 默 认 使 用 下 面 这 种 格式 ， 非常 元 长 ,但 给 出 了 每 个 HTTP 请 求 的 实用 信息 。 这 跟 其 他 
Web 服 务 需 很 像 ， 比 如 Apache， 创 建 它 们 的 日 志文 件 : 


':remote-addr - - [:datel] ":method :Url HTTP/:http-version" :status 
:reslcontent-length|] ":referrer" ":user-agent™"' 


其 中 的 ' :something' 是 一 些 符 和 号， 在 真正 的 日 志 记 录 中 它们 包含 的 是 来 日 HTTP 请 求 的 真 
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实 值 。 比 如 说 ， 一 个 简单 的 cur1l (1) 请 求 会 生成 下 面 这 样 一 条 日 志 : 


127.0.0.1- - [Wed, 28 Sep 2011 04:27:07 GMT] 
"GET / HTTP/1.1" 200 - "—" 
"curl/7.19.7 (universal-apple-darwin10.o0) 
libcurl/7.19.7 OpenSSL/0.9.81 zl1ib/1.2.3" 


2. 定制 日 志 格 式 

logger () 最 基本 的 用 法 不 需要 任何 定制 。 但 你 可 能 想 要 个 定制 格式 来 记录 其 他 信息 ， 或 者 
让 它 不 那么 见长 , 或 者 提供 定制 的 输出 。 要 定制 日 志 的 格式 , 你 可 以 传人 一 个 定制 的 信 令 字符 串 。 
比如 下 面 这 种 格式 会 输出 GCET /users 15 ms 这 种 格式 的 日 志 : 


var app = connectr) 
.USe(connect.logger(':method :Url :response-time ms')})) 

















.USe (hello).: 
默认 情况 下 ， 你 可 以 使 用 下 面 这 些 信 令 ( 注意 ， 尖 名称 对 大 小 写 不 敏感 ): 
口 :regq[ 头 名 称 ] 比如 : :regq[Accept] 
:res[ 头 名 称 ] 比如 : :res[Content-Length] 





:http-version 
:response-time 
:remote-addr 


:date 





:method 
:url 
:referrer 


:USer-agent 


DD DUDUDUUUUU UO 


:Status 
定义 定制 的 信 令 也 不 难 。 你 只 需要 给 connect .1logger .token 国 数 提 供 信 邻 名 称 和 回调 辑 
数 就 行 。 比 如 说 ， 你 想 记录 所 有 请 求 的 查询 字符 ， 可 以 这 样 定义 它 : 


Var url = regquire('url'); 





connect,logger.token!( 'gqguery-string', function (reg, res}t 
return url .parse (regq.url) .gquery; 


17); 

除了 默认 的 格式 ，logger () 还 有 其 他 预定 义 的 格式 ， 比 如 short 和 tiny。 为 一 个 预定 义 的 
格式 是 aev, 可 以 为 开发 输出 简洁 的 日 志 , 适用 于 那 种 只 有 你 一 个 人 在 网 站 上 , 并 且 不 关心 HTTP 
请 求 细 节 时 的 情况 。 这 个 格式 还 会 根据 响应 状态 码 设置 不 同 的 颜色 : 200 是 绿色 的 ，300 是 蓝 色 ， 
400 是 黄色 ，500 是 红色 。 这 种 颜色 划分 对 开发 很 有 帮助 。 

要 使 用 预定 义 的 格式 ， 只 需要 把 名 字 传 给 logger () : 


Var app = Connect') 
.Use (connect.logger{'dev')) 
.Use (hello).; 


你 已 经 知 直 如 何 格式 化 1ogger 的 输出 了 上 ， 接 下 来 我 们 看 看 你 能 提供 哪些 选项 给 它 。 
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3. 日 志 选 项 : STREAM、IMMEDIATE 和 BUFFER 

如 前 所 述 ， 你 可 以 用 选项 调整 logger () 的 行为 。 

stream 就 是 这 样 的 选项 ， 你 可 以 给 logger 传 递 一 个 Node Stream 实 例 ， 用 来 代替 stdout 写 
入 日 过 。 这 样 你 可 以 把 日 志 输 出 到 它 目 己 的 日 志文 件 中 ， 独 立 于 服务 硕 目 己 输 出 时 用 
fs.createWriteStream 创 建 的 Stream 实 例 。 

在 你 使 用 这 些 选 项 时 ， 通 常 也 应 该 包括 format 属 性 。 下 面 这 个 例子 使 用 了 定制 的 格式 ,将 
日 志 输 出 到 /var/log/myapp.log 中 ， 因 为 有 追加 标记 ， 所 以 在 程序 启动 时 日 志文 件 不 会 被 截断 : 











var fs = require('fs') 
Var log = fs.createWriteSstream!{('/var/log/myapp.log’', { flags: ‘'a’' }) 
Var app = connectr) 
.USe {connect.logger{({ format: ':method :Url stream: lJ]og })) 
.USE('/error', error) 


.use (hello); 
immeaiate 是 另 一 个 选项 , 使 用 这 个 选项 ,一 收 到 请 求 就 写 日 志 ， 而 不 是 等 到 响应 后 。 如 果 
你 的 服务 器 保持 请 求 长 开 ， 并 且 你 想 知道 连接 什么 时 候 开始 ， 就 可 以 用 这 个 选项 。 或 者 用 它 来 调 
试 程序 中 的 关键 部 分 。 这 就 是 说 不 能 使 用 :status 和 :tresponse-time 之 类 的 信 令 ,因为 它们 是 
跟 啊 应 相关 的 。 要 局 用 即刻 模式 ， 可 以 传人 取信 为 true 的 immedqiate， 代 人 码 如 下 所 示 : 


var app = ConnmnecCct | 
.USe{connect.logger{{ immediate: true })) 
.USE!{'/error', error) 

















.use (hel10); 

第 三 个 选项 是 puffer， 可 以 用 来 降低 往 人 硬盘 中 写 日 志文 件 的 次 数 。 如 果 你 要 通过 网 络 写 日 
志文 件 ， 并且 想 降低 网 络 活动 的 次 数 ， 这 个 更 有 用 。buffer 选 项 接受 一 个 数值 ， 以 毫秒 为 单位 
指定 绥 冲 区 刷新 的 时 间 间 隔 ， 或 者 只 传人 true 使 用 默认 间隔 。 

这 就 是 日 志 记 录 ! 接 下 来 我 们 去 看 看 favicon 中 间 件 。 

















7.2.2 favicon(): 提供 favicon 








favicon 是 网 站 的 小 图 标 ， 显 示 在 浏览 硕 的 地 址 栏 和 收藏 栏 里 。 为 了 得 到 这 个 图 标 ,， 浏 览 善 会 
请 求 /favicon.ico 文 件 。 一 般 来 说 ， 最 好 尽快 啊 应 对 favicon 文 件 的 请 求 ， 这 样 程 序 的 其 他 部 分 就 可 
以 忽略 它们 了 。favicon() 中 间 件 默认 会 返回 Connect 的 favicon ( 当 没 有 参数 传 给 它 时 )。 这 个 
favicon 如 图 7-1 所 示 。 











BOO0O < local 


全 @ | | local/ 





Hello World! 


图 7-1 ”Connect 的 默认 favicon 
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基本 用 法 

favicon () 一 般 放 在 中 间 件 栈 的 最 顶端 , 所 以 连日 志 都 会 忽略 对 favicon 的 请 求 。 然后 这 个 图 
标 就 会 缓存 在 内 存 中 ， 可 以 更 快 地 响应 后 续 请 求 。 

下 面 这 个 例子 给 favicon() 传 人 了 一 个 参数 ， 这 是 一 个 .ico 文 件 的 路 径 ， 从 而 用 这 个 定制 
的 ,ico 文 件 啊 应 对 favicon 文 件 的 请 求 : 


Connectt) 





.USe{connect.favicon!{ dirname + '/public/favicon.ico')) 





.USe (connect.logger!{})) 
.USel(function(regq, res) 1 
res.end({'Hello World!\nm').: 


J 

此 外 ， 还 可 以 传人 一 个 maxaAge 人 参数 ， 指 明 浏 览 融 应 该 把 favicon 放 在 内 存 中 绥 存 多 长 时 间 。 

接 下 来 我 们 还 有 一 个 小 而 实用 的 中 间 件 : methodqoverziaqe () 。 当 客户 端 能 力 有 限时 , 它 可 
以 提供 一 种 方案 ， 用 于 伪造 HTTP 请 求 方法 。 








7.2.3 methodoverride(): 伪造 HTTP 方 法 


当 你 构建 一 个 使 用 特殊 HTTP 谓词 的 服务 需 时 ， 比 如 PUT 或 DELETE， 在 浏览 需 中 会 出 现 一 个 
有 趣 的 问题 。 浏 览 器 的 <form> 只 能 GET 或 PopST， 所 以 你 在 程序 中 也 不 能 使 用 其 他 方法 。 

一 种 常见 的 解决 办 法 是 添加 一 个 <input type=hidden>， 将 其 值 设 定 为 你 想 用 的 方法 名 ， 
然后 让 服务 如 检查 那个 值 并 “ 假 疙 ” 它 是 这 个 请 求 的 请 求 方法 。methodoverride() 是 这 项 技术 
中 服务 絮 这 边 的 解决 办 法 。 














1. 基本 用 法 
HTML 输 入 控件 上 默认 的 名 称 是 _method, 但 你 可 以 给 methodoverride() 传 人 一 个 定制 值 ， 
代码 如 下 所 示 : 
connect{() 
.USe(connect.methodOverride(' method ‘')) 


11gten(3000) 
为 了 阐明 methodoverriqde() 是 如 何 实现 的 , 我 们 来 创建 一 个 更 新 用 户 信息 的 微型 程序 。 这 
个 程序 中 会 有 一 个 表单 ， 当 表单 经 浏览 硕 提 区 并 被 服务 天 处 理 后 ,会 用 一 个 简单 的 成 功 消息 做 啊 
应 ， 如 图 7-2 所 示 。 
这 个 程序 用 两 个 中 间 件 更 新 用 户 数据 。 在 update 国 数 中 ， 如 果 请 求 方法 不 是 Pur ， 就 调用 
next () o 就 像 前 面 说 过 的 ， 大 多 数 浏 览 需 都 会 无 视 表 单 属性 method= "Es 所 以 下 面 这 段 代 
码 不 能 正常 工作 。 
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local 
一 © | © local/ 信 白 外 


Updated name to Loki 


图 7-2” 用 methodoverride() 模 拟 PUT 请 求 ， 更 新 浏览 大 中 的 表单 





代码 清单 7-4 不 可 用 的 用 户 更 新 程序 


Var connect = require('connect').; 





function edit (req, res, next) { 

if ('GET' l= regq.method) return next()}); 

res.setHeader('Content-Type', 'text/html'); 

res.write('<form method="put">'); 

res.write('<input type="text" name="user[name]" value="Tobi" />'); 
res.write('<input type="submit" value="Update" />'); 
( 











res.write('</form>').， 
res.end!(),; 
} 
function update (regq, res, next) { 
ift ('PUT' l= regq.method) return next()}); 
res.end({'Updated name to ' + req.body.user.name); 
} 
var app = Connect() 


.usSe(lconnect.logger('dev')) 
.USe (connect.bodypParser!()) 
.use (edit) 

.USe (update}).; 


| 
| 
| 
app.listen(3000); 


这 个 更 新 程序 看 起 来 应 该 像 代码 清单 7-5 这 样 。 在 表单 中 加 了 一 个 名 为 _methogd 的 输入 控件 ， 
并 且 在 bodyParser() 下面 加 上 了 methodoverride()，, 因为 它 要 引用 reg .body 访 问 表单 数据 。 
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代码 清单 7-5 ”使 用 methodoverriqde() 的 用 户 更 新 程序 
var connect = regquiré(l'connect'); 


function editl(req, res, next) { 
if ('GET' != req.method) return next(): 
res.setHeader('Content-Type', 'text/html')}): 
res.write({'<form method="post'">'); 

('<input type="hidden" name="_ method" value="put" />'}); 
res.write('<input type="text" name="userlname]" value="Tobi" />'); 
{('<input type="submit" value="UpPdate" />'); 
{('</form>'); 





} 


function update(req, res, next) f{ 


if ('PUT' != regq.method) return next(}); 
res.end{({'Updated name to ' + req.body.user.name): 
} 
Var app = Connect') 


.Use(connect.logger!('dev')) 
.UsSe (connect.bodyParser()) 
.UsSe{(connect.methodOoOverrider(})) 
.USe (edit) 

.use (update) 

.Jisten{(3000);: 


2. 访问 原始 的 req .method 
methodOoverride() 修 改 了 原始 的 req.method 属 性 , 但 Connect 复 制 了 原始 方法 , 你 随时 都 
可 以 访问 rea.originalMethod。 也 就 是 说 对 于 前 面 那个 表单 而 言 ， 可 以 输出 下 面 这 样 的 值 : 


console.log(regq.method}).; 

















/Ai nl PUT nl 
console,.log(regq.originalMethod}).: 
A 11 POST!" 


对 于 一 个 简单 的 表单 而 言 ， 这 些 工 作 看 起 来 可 能 有 点 儿 多 了 ， 但 我 们 癌 你 保证 ， 等 到 第 8 曹 
讨论 Express 的 高 级 特性 ， 以 及 第 11 章 的 模板 时 ， 这 会 变 成 更 愉悦 的 体验 。 我 们 接 下 来 要 看 的 是 
vhost () ， 一 个 基于 主机 名 提供 服务 的 小 中 间 件 。 








7.2.4 vhost (): 虚拟 主机 


vhost ()( 虚拟 主机 ) 中 间 件 是 一 种 通过 请 求 头 Host 路 由 请 求 的 简单 、 轻 量 的 办 法 。 这 项 任 
务 通 名 是 由 反 回 代理 完成 的 ， 可 以 把 请 求 转发 到 运行 在 不 同 端口 上 的 本 地 服务 需 那 里 。vhost () 
组 件 在 同一 个 Node 进 程 中 完成 这 一 操作 ， 它 将 控制 权 交 给 跟 vhost 实 例 关 联 的 Node HITP 服 务 需 。 

1. 基本 用 法 

跟 所 有 Connect 目 带 的 中 间 件 一 样 ， 一 行 代码 就 可 以 把 vhost () 跑 起 来 。 它 有 两 个 参数 : 第 
一 个 是 主机 名 ，vhost 实 例会 用 它 进 行 匹 配 。 第 二 个 是 http .Servezr 实 例 ， 用 来 处 理 对 相 匹 配 
的 主机 名 发 起 的 HTTP 请 求 ( Connect 程 序 都 是 http .Server 的 子 类 , 所 以 程序 实例 可 以 胜任 这 项 
工作 )。 
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Var Connect = require('connect').; 


Var Server = connect() 
var app = require('./sites/expressijs.dev'); 





server.use (connect.vhost{('expressjs.dev', app))}); 





server.listen(3000}); 


为 了 能 用 前 面 那 个 ./sites/expressjs.dev 模 块 ， 它 应 该 像 下 面 这 个 例子 这 样 ， 把 HTTP 服 务 磊 冉 


给 module. exports: 





var http = require('http') 
module.exports = http.createServer (functionlreq, res}t 
res.end({('hello from expressijs.cCom\n')}).; 


1 
2. 使 用 多 个 vhost () 实例 
跟 其 他 中 间 件 一 样 , 在 一 个 程序 中 可 以 多 次 使 用 vhost () ,将 几 个 主机 关联 到 它们 的 程序 上 


var app = require('./sites/expressjs.dev');: 
server.use(connect.vhost('expressjs.dev', app}))}); 














var app = require(',./sites/learnboost.dev'): 
Server.use (connect.vhost('learnboost.dev', appl)); 


你 也 可 以 不 这 样 手 动 设置 vnost ()，, 而 是 从 文件 系统 中 生成 一 个 主机 列表 。 具体 做 法 如 下 例 
所 示 ， 用 fs .readdirSsync() 方 法 返回 一 个 目录 实体 的 数组 . 








Var Connect = require('connect') 

var fs = require({'fs'),; 

Var app = connect!() 

Var Sites = fs.readdirSync('source/sites'):; 


sites.forEach (function(site)}t 
console.log('! ..,， Ss', site). 
app.use(connect,.vhost(site, requirel('./sites/' + site)})}); 


}); 

app.listen(3000) ; 

vhost () 用 起 来 比 反 回 代理 简单 。 可 以 把 所 有 程序 作为 一 个 单元 管理 。 对 于 要 提供 几 个 小 网 
站 ， 或 者 大 部 分 由 静态 内 容 构 成 的 网 站 来 说 ， 这 种 方式 很 理想 ; 但 它 也 有 人 缺点， 如果 一 个 网 站 引 
发 了 央 汗 ， 你 的 所 有 网 站 都 会 宕 反 〈 因 为 它们 都 运行 在 同一 个 进程 中 )。 

接 下 来 我 们 要 看 一 个 最 基础 的 Connect 中 间 件 : 会 话 管理 组 件 session(), 它 依赖 于 对 cookie 
签名 的 cookieParser ()。 








7.2.5 session(): 会 话 管 理 


在 第 4 草 中 ， 我 们 介绍 了 Node 提 供 的 实现 会 话 这 种 概念 所 需 的 所 有 办 法 ,但 它 并 没有 上 自己 的 
实现 。 按 照 Node 小 核心 大 外 延 的 一 般 原则 ， 会 话 管理 也 被 留 给 了 Node 的 第 三 方 附 加 组 件 。 而 这 
正 是 session() 中 间 件 要 解决 的 问题 。 

Connect 的 session() 组 件 提 供 了 了 强健、 直观、 由 社区 支持 的 会 话 管 理 ， 它 所 支持 的 会 话 存 
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储 ， 从 默认 的 内 存 存储 到 基于 Redis、MongoDB 、CouchDB 和 cookies 的 存储 ， 多 种 多 样 。 本 节 会 
讨论 如 何 设 置 session() 中 间 件 ， 处 理会 话 数据 ， 并 用 Redis 的 键 / 值 存储 作为 可 选 的 会 话 存储 。 

我 们 先 把 中 间 件 设置 起 来 ， 并 探索 一 下 它 有 哪些 选项 可 用 。 

1. 基本 用 法 

如 前 所 述 ， 中 间 件 session() 需 要 用 签名 cookie， 所 以 你 应 该 在 它 上 面 使 用 cookieParser () ， 
并 传 给 它 一 个 秘 钥 。 

代码 清单 7-6 实 现 了 一 个 最 简 配 置 的 页 面 浏 览 计数 程序 ， 它 没 给 session() 传 入 选项， 用 的 
是 默认 的 内 存 数 据 存储 。Connect 中 默认 的 会 话 cookie 名 是 connect.sida， 并 且 被 设 定 为 
httpon1y， 也 台 是 说 客户 端 脚本 不 能 访问 它 的 值 。 但 有 些 可 以 调整 的 选项 ， 你 很 快 就 能 见 到 。 


代码 清单 7-6 “一 个 使 用 session 的 页 面 浏览 计数 器 


var connect = require('connect').; 














var app = Connect ( ) 
.USe (connect,. favicont()) 
.USe (connect.cookieParser('keyboard cat')})) 
.UsSe(connect.session()) 
.USel(function{regq, res, next)t 


Var SesgSs = req.session; 

If (sess.views) { 
res.setHeader('Content-Type', 'text/html')}):; 
res.write('<p>views: ' + Sess.views + ‘'</p>');: 
res.end!{(}),; 


SESS .VIEewSst+: 
} else { 
Sess.views = 1; 
res.,end{({'welcome to the session demo. refresh!'): 


> 

app. listen(3000); 

2. 设 定 会 话 有 效 期 

假定 你 想 让 会 话 在 24 小 时 后 过 期 ， 只 在 使 用 HTTPS 时 才 发 送 会 话 cookie， 并 且 要 配置 会 话 的 
名 称 。 你 可 以 传人 下 面 这 样 的 对 象 : 


var hour = 3600000 : 
var sessionOpts = { 








key: 'myapp_sid', 
cookie: { maxAge: hour * 24, secure: true } 


.USe(connect.cookieParser!('keyboard cat ' ) ) 
.USsSe(connect.session (sessionoOpts)) 


使 用 Connect ( 以 及 下 一 章 的 Express ) 时 ， 你 经 党 要 设 定 maxage， 以 室 秒 为 单位 指定 从 那 一 
时 点 开始 的 时 长 。 这 种 表示 未 来 时 间 的 表达 方法 通常 更 直观 ， 本 质 上 等 同 于 new Date (Date. 


now() + maxAde) 。 
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会 话 设置 好 了 ， 接 下 来 我 们 来 看 一 下 处 理会 话 数 据 时 的 方法 和 属性 。 

3. 处 理会 话 数据 

Connect 的 会 话 管 理 非常 创 单 。 其 基本 原理 是 当 请 求 完成 时 ， 赋 给 req .session 对 和 象 的 所 有 
属性 都 会 被 保存 下 来 ; 当 相 同 的 用 户 〈 浏 览 锅 ) 再 次 发 来 请 求 时 ,会 加 载 它 们 。 比 如 说 ,保存 购 
物 车 信息 就 像 将 一 个 对 和 象 赋 给 cart 属 性 那么 人 简单， 如 下 所 示 : 

redq.session.cart = { items: [1,2,3] }; 

当 你 在 后 续 的 请 求 中 访问 req.session.cart 时 ， 就 可 以 得 到 .items 数 组 。 因 为 这 是 个 稼 
规 的 JavaScript 对 象 , 所 以 你 可 以 在 后 续 的 请 求 中 调用 这 个 般 入 对 象 上 的 方法 , 像 下 面 这 个 例子 中 
这 样 ， 并 且 它 们 能 像 你 期 望 的 那样 保存 下 来 : 

redq.session.cart.items .push(4); 

在 使 用 会 话 对 象 时 ， 有 一 点 一 定 要 记 住 ， 会 话 对 象 在 各 个 请 求 间 会 被 串 行 化 为 JSON 对 象 ， 
所 以 req.session 对 象 有 跟 JSON 一 样 的 局 限 性 : 不 允许 循环 属性 ,不 能 用 函数 对 象 ，Date 对 和 象 
无 法 正确 串 行 化 等 等 。 在 使 用 会 话 对 象 时 ， 一 定 要 记 住 这 些 限制 。 

Connect 会 自动 保存 会 话 数据 , 但 它 内 部 是 通过 调用 session.save([callback]) 方 法 完成 
的 , 这 是 一 个 公开 的 API。 此 外 还 有 两 个 辅助 方法 , Session.destroy () 和 Session.regenerate ()， 
在 对 用 户 进行 认证 以 防止 会 话 固定 攻击 时 经 党 用 到 它们 。 在 后 续 草 节 中 , 当 你 使 用 Express 构 建 程 
序 时 ， 你 会 用 这 些 方法 做 认证 。 

我 们 继续 前 进 ， 去 探 纵 会 话 cookie 吧 。 

4. 操纵 会 话 cookie 

Connect 人 允许 你 为 会 话 提 供 全 局 cookie 设 定 ， 但 也 可 以 通过 Session.cookie 探 纵 特 定 的 
cookie， 它 默认 是 全 局 设 定 。 

在 你 开始 调整 那些 属性 之 前 , 我 们 先 把 前 面 那 个 会 话 程序 扩展 一 下 , 把 所 有 属性 都 号 入 啊 应 
HTML 中 的 单个 <p> 标 记 中 ， 看 看 这 些 会 话 cookie 的 属性 ， 如 下 所 示 : 


















































res.writel'<P>ViewSs: ' + SeESS.VIiews + '</pP>');} 

res.writel(l'<p>explires in: ' + (sess.cookie.maxAge / 1000) + 's</p>'); 
res.write(l'<p>httpOnly: ' + Sess.cookie.httpOnly + '</p>'); 
res.write{l'<p>path: ' + sess.cookie.path + '</p>'); 
res.writel(l'<p>domain: ' + Sess.Cookie.domain + '</pP>'),; 
res.write{':<p>secure: ‘+ Sess.cookie.secure + '</p>'};， 


在 Connect 中 ，cookie 的 所 有 属性 ， 比 如 expires、httponly、secure、path 和 domain， 者 
可 以 通过 编程 针对 每 个 会 话 进行 修改 。 比 如 说, 你 可 以 像 下 面 这 样 让 一 个 活动 的 会 话 在 5 秒 内 失效 ， 

red. Session.cookie,expires = new Date(Date.now{) + 5000) ; 

设置 过 期 时 间 的 另 一 个 更 直观 的 API 是 .maxage 访 问 和 项 ， 可 以 按 曼 秒 获取 和 设 定 相 对 当前 时 
间 的 时 间 值 。 下 面 这 段 代码 也 会 让 会 话 在 5 秒 内 过 期 : 

redq.session.cookie.maxAge = S5000; 


剩 下 的 属性 ，dqomain、path 和 secure， 限 定 了 cookie 的 作用 域 ， 按 域名 、 路 径 或 安全 连接 来 
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限定 它 ， 而 httponly 可 以 防止 客户 端 脚本 访问 cookie 数 据 。 这 些 属 性 都 可 以 按 相 同 的 方式 操纵 : 


redq.session.cookie.path = :17admin' : 
req.session.cookie.httpOnly = false; 


之 前 你 一 耳 在 用 默认 的 内 存 存 储 保 存 会 话 数 据 , 接 下 来 我 们 要 看 看 如 何 插 和 人 其 他 的 会 话 数据 
存储 方式 。 

5. 会 话 存储 

内 置 的 connect .session.MemoryStore 是 一 种 简单 的 内 存 数据 存储 ， 非 党 适合 运行 程序 
测试 ， 因 为 它 不 需要 其 他 依赖 项 。 但 在 开发 和 生产 期 间 ， 最 好 有 一 个 持久 化 的 、 可 扩展 的 数据 存 
放 你 的 会 话 数 据 。 

虽然 任何 数据 库 都 可 以 做 会 话 存储 ， 但 低 延 民 的 键 / 值 存储 最 适合 这 种 多 失 性 数据 。Connect 
社区 已 经 创建 了 几 个 使 用 数据 库 的 会 话 存储 ， 包 括 CouchDB 、MongoDB 、Redis、Memcached、 
PostgreSQL 以 及 其 他 数据 库 。 

你 在 这 里 将 会 使 用 Redis 和 connect-redis 模 块 。 第 5 章 已 经 讲 过 如 何 用 node redis 模 块 跟 Redis 交 
互 了 了。 现在 你 将 学 到 如 何在 Connect 中 用 Redis 存 储 会 话 数 据 。Redis 文 持 键 的 有 歼 期 ， 性 能 很 好 ， 
并 且 吻 于 安 闻 ， 所 以 很 适合 用 来 文 持 会 话 数 据 的 存储 。 

你 在 看 第 5 草 时 应 该 已 经 疙 过 Redis 了 , 但 为 了 保险 起 见 , 还 是 运行 下 redis-server 确 认 一 下 吧 : 

ee 16:11:54 * Server started, Redis version 2.0.4 

[11790] 16 Oct 16:11:54 * DB loaded from disk: 0 seconds 

[11790] 16 Oct 16:11:54 * The server is now ready to accept 


connections on port 6379 
[11790] 16 Oct 16:11:55 - DB 0: 522 keys (0 volatile) in 1536 slots HT. 


接 下 来 ， 把 connect-redis 添 加 到 package.json 文 件 中 ， 运 行 npm instal1 安 装 它 ， 或 者 直接 
执行 npm install connect-redis,。 connect-redis 模 块 提供 了 一 个 也 数 ， 应 该 把 connect 传 给 
它 ， 代 人 码 如 下 所 示 : 


























Var Connect = require('connect') 
var RedisStore = require('connect-redis') (connect), 
Var app = connect{) 


.USe (connect.favicon(})) 
.USe (connect.cookieParser('keyboard cat:)) 
.Use(lconnect.session({ store: new RedisStorel{{ prefix: 'sid' }) 1})) 





将 connect5 | 用 传 给 connect-redis， 它 可 以 继承 connect .Session.Store.prototype。 
为 在 Node 中 ， 一 个 进程 里 可 能 会 同时 使 用 多 个 版 本 的 模块 ， 所 以 这 很 重要 。 把 指定 版 本 的 
Connect 传 给 它 ， 你 就 可 以 确保 connect-redis 用 的 是 正确 的 副本 。 

RedisStore 作 为 store 的 值 传 给 了 session()，, 你 想 用 的 所 有 选项 ,比如 会 话 用 的 键 前 级 ， 
都 可 以 传 给 Redaisstore 构 造 硕 。 

险 ! 讨论 了 这 么 多 跟 会 话 有 关 的 内 容 , 核心 概 念 中 间 件 全 部 讨论 完了 。 接 下 来 我 们 要 讨论 处 
理 Web 程 序 安 全 的 内 置 中 间 件 。 对 于 需要 保证 数据 安全 的 程序 来 说 ， 这 是 一 个 非常 重要 的 主题 。 
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7.3 处理 Web 程序 安全 的 中 间 件 


我 们 已 经 说 过 很 多 次 了 ，Node 的 核心 API 刻 意 售 留 在 底层 。 也 就 是 说 它 没 有 为 构建 Web 程 序 
提供 内 置 的 安全 或 最 佳 实践 。 好 在 Connect 来 了 ， 它 为 你 实现 了 可 以 用 在 Connect 程 序 中 的 这 些 安 
全 实践 。 

本 市 会 青 教 你 三 个 Connect 内 置 的 中 间 件 ， 这 次 是 跟 安 全 相关 的 : 

口 pasicAuth() 为 保护 数据 提供 了 HTTP 基 本 认证 ; 

D csrf() 实现 对 路 站 请 求 伪 造 (CSRF ) 攻击 的 防护 ; 

D srzrorHandqler() 帮 你 在 开发 过 程 中 进行 调试 。 

首先 ，basicauth() 实 现 了 HTTP 基 本 认证 ， 对 程序 中 的 受 限 区 域 进行 保护 。 














7.3.1 basicaAuth(): HTTP 基 本 认证 


在 第 6 草 6.4 帮 ， 你 创建 了 一 个 简陋 的 基本 认证 中 间 件 。 好 吧 ， 事 实证 明 ，Connect 目 珊 了 一 个 
真正 的 实现 。 如 前 所 述 ， 基 本 认证 是 非常 简单 的 HITP 认 证 机 制 ， 并 且 在 使 用 时 应 该 小 心 ， 因 为 
如 采 不 是 通过 HTTPS 进 行 认 证 ， 用 户 和 凭证 很 可 能 会 被 攻击 者 稚 获 。 

那 就 是 说 ， 它 可 以 用 来 给 小 型 或 个 人 程序 添加 一 个 人 简便 快捷 的 认证 。 

如 采 你 的 程序 用 了 basicauth() 组 件 ， 浏 览 硕 会 在 用 户 第 一 次 连接 程序 时 提示 用 户 输入 攒 
证 ， 如 图 7-3 所 未。 











The server local:80 requires a username and password. 
The server says: Authorization Required. 





User Name: 





Password: 


( Cancel ) ( Logln 
lt aa 


图 7-3 ”基本 认证 提示 框 


1. 基本 用 法 
basicaAuth () 提 供 了 三 种 验证 用 户 凭 证 的 方法 。 第 一 种 是 传人 用 户 名 和 密码 ， 如 下 所 示 : 
var app = connect') 

.use (connect.basicAuth{('tIj', tobi'})}); 


2. 提供 回调 函数 
第 二 种 是 传 给 basicautnh () 一 个 回调 机 数 来 验证 用 户 任 证， 这 个 郴 数 必须 返回 true 表示 成 
功 。 这 对 于 要 用 哈 希 检查 用 户 任 证 非常 有 帮助 : 
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Var users = { 
契合 所 本 二 EO0", 
lokis 'bar.', 
jane: 'baz'! 

上 

Var app = Connect() 


.Use (connect.basicAuth (function{user, pass)t 
return users[user] === pass; 


了 
3. 提供 异步 回调 函数 
最 后 一 种 办 法 和 第 二 种 类 似 ， 只 是 这 次 传 给 basicauth() 的 函数 有 三 个 参数 ， 并 且 可 以 使 
用 异步 查询 。 这 在 用 便 盘 上 的 文件 ， 或 通过 查询 数据 库 进 行 验证 时 很 有 用 。 


代码 清单 7-7 做 异步 查询 的 Connect basicaAuth () 中 间 件 





Var app = conmnect ( ) ; 
执行 数据 库 验证 
app.use (connect.basicAuth (function(user, pass, callback)t 函数 
User.authenticate({ user: user, pass: pass }，gotUser) ，; 
function gotUser lerr, user}) 1 a We 
if (err) return callback (err); 当 数 据 库 响应 完成 时 
运行 异步 回调 函数 


把 从 数据 库 里 得 到 的 usez 对 象 


callback (null, user).; 
传 给 basicAuth() 的 回调 函数 


})); 


4. 使 用 cur1 (1) 的 例子 
假定 你 想 限 制 所 有 发 往 你 的 服务 天 的 访问 ， 你 可 能 会 这 样 设 置 程序 : 





Var Connect = requirel('connect'); 
var app = ConmnecCt Tt | 
.USe (connect.basicAuth('tobi', 'ferret')) 


.UsSe(function (reg, res) ff 
res.end{'"I'm a secret‘\n'"): 


jh 


app.listen(3000); 


现在 试 着 用 curl (1) 向 服务 器 发 送 一 个 HTTP 请 求 ， 然 后 你 会 看 到 你 未 被 授权 : 


$ curl http://localhost -1 

HTTPE/1.1 401 Unauthorized 

WNW-AUuthenticate: Basic realm="Authorization Regquired" 
Connection: keep-allive 

Transfer-Encoding: chunked 





Unauthorized 

用 HTTP 基 本 授权 和 攒 证 发 起 相同 的 请 求 ( 注 意 URL 的 开始 部 分 ) 可 以 访问 : 
$ curl --user tobi:ferret http://localhost -1 

HTTP/1.1 200 OK 

Date: Sun, 16 Oct 2011 22:42:06 GMT 

Cache-Control: public, max-age=0 


Last-Modified: Sun, 16 Oct 2011 22:41:02 GMT 
ETag: "13-1318804862000" 
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Content-Type: text/plain; charset=UTF-8 
Accept-Ranges: bytes 

Content-Length: 13 

Connection: keep-alive 


TI'm a secret 


继续 本 市 安全 这 一 主题 ,我 们 去 看 一 人 csrf () 中间 件 , 它 是 用 来 防护 跨 站 请 求 伪 造 攻击 的 。 





7.3.2 csrf(): 路 站 请 求 伪 造 防 护 


跨 站 请 求 伪 造 (CSRF ) 利用 站 点 对 浏览 锅 的 信任 漏洞 进行 攻击 。 经 过 你 的 程序 认证 的 用 户 
访问 攻击 者 创建 或 攻陷 的 站 点 时 , 这 种 站 点 会 在 用 户 不 知情 的 情况 下 代表 用 户 向 你 的 程序 发 起 请 

这 是 一 种 复杂 的 攻击 ， 所 以 我 们 来 举例 说 明 。 假 定 在 你 的 程序 中 ， 请 求 DELETE /account 会 
导致 用 户 的 账号 被 销毁 ( 尽管 只 有 已 登录 用 户 可 以 发 起 请 求 )。 而 用 户 此 时 又 恰好 访问 了 一 个 不 
能 防护 CSRF 的 论坛 。 攻击 者 可 以 提交 一 段 脚 本 发 起 DELETE /account 请 求 ， 销毁 用 户 的 账号 。 对 
于 你 的 程序 来 说 ， 这 是 很 糟糕 的 状况 ，csrf () 中 间 件 可 以 帮 你 防护 这 样 的 攻击 。 

csrf () 会 生成 一 个 包含 24 个 字符 的 唯一 ID, 认证 令 牌 , 作为 req .session._csrf 附 到 用 户 
的 会 话 上 。 然 后 这 个 令 牌 会 作为 隐藏 的 输入 控件 _csrf 出 现在 表单 中 ，CSRF 在 提交 时 会 验证 这 
个 令 脾 。 这 个 过 程 每 次 交互 都 会 执行 。 

基本 用 法 

为 了 确保 csrf () 可 以 访问 reqg . body. _csrf( 隐藏 输入 控件 的 值 ) 和 teda .SeEsslion. CSLrf， 
你 要 确保 csrf () 添加 在 了 bodqyParser() 和 session() 的 下 面 ， 如 下 例 所 示 : 


connectrt{) 
































.USe (connect .bodyParser!{)) 





.USE {connect.cookieParser!{'secret')})) 





.USe {connect.sessiont()) 
.USe (connect.csrf()).; 


在 Web 开 发 的 安全 方面 ,还 有 一 点 需要 注意 ， 即 要 确保 见长 的 日 志和 详细 的 错误 报告 不 能 同 
时 出 现在 生产 和 开发 环境 中 。 我 们 看 一 下 errorHandler () 中间 件 ， 它 就 是 要 解决 这 个 问题 的 。 














7.3.3 errorHandler(): 开发 错误 处 理 


Connect 目 种 的 errorHandler () 中 间 件 很 适合 用 在 开发 中 ,， 它 可 以 基于 请 求 头 域 Accept 提 
供 详尽 的 HTML、JSON 和 普通 文本 错误 啊 应 。errorHandler () 是 要 用 在 开发 过 程 中 的 ， 不 应 
该 出 现在 生产 环境 中 。 








1. 基本 用 法 
这 个 组 件 一 般 应 该 放 在 最 后 ， 这 样 它 才能 捕获 所 有 钳 误 : 
var app = Connect Tt 


.UsSe(connect.logger{('dev')) 
.USe(function(req, res, next)}t 
setTimeout (function () { 
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next (new Error{'something broke!')):; 
}, 500);， 
}) 


.USe{connect.errorHandlert()}); 

2. 接收 HTML 错 误 响 应 

如 果 按 照 这 里 的 配置 ,你 在 浏览 妖 中 查看 任何 页 面 时 都 会 看 到 图 7-4 所 示 的 Connect 错 误 页 面 ， 
显示 错误 消息 、 啊 应 状态 和 全 部 堆栈 跟踪 信息 。 


$$ Error: something brokel 


个 GC | © locall Z 窜 | 六 古国 六 


Connect 


500 Error: something broke! 


at Object.handle (/Usersfj/Projects/node-in-action/source/connect-middleware-errorHandler.js:12:10) 
at next (/Users/tj/Projects/connect/lib/proto.js:179:15) 

at Object.logger [as handle] (UsersAitj/Projects/connect/ib/middleware/logger.js:155:5) 

at next (/UsersNtj/Projects/connect/ib/proto.js:179:15) 

at Function.handle (/UsersN/Projects/connect/ib/proto.js:192:3 

at Server.app (/Usersit/Projects/connect/lib/connect.js:53:31) 

at Server.emit (events.js:67:17 

at HTTPParser.onincoming {http.js:1134:12) 


at HTTPParser.onHeadersComplete (http.js:108:31) 





at Socket.ondata {http.js:1029:22) 


图 7-4 Connect 默认 的 errorHandlerO) 显 示 在 浏览 器 中 的 样子 


3. 接收 普通 文本 错误 员 应 

nA 它 离 返回 一 ep ` 有 很 大 距 

所 以 errorHandler () 默认 会 用 text/plain 格 式 做 啊 应 ， 这 非常 适合 curl (1) 这样 的 命令 
行 HTTP 客 户 端 。 在 stdout 中 的 输出 如 下 所 示 : 


$ Curl http://localhost/ 
Error: something broke! 
at Object.handle (/Users/tj/Projects/node-in-action/source 
/connect-middleware-errorHandler.js:12:10) 
at next (/Users/tj/Projects/connect/1ib/proto.jJs:179:15) 
at Object.logger [as handle] (/Users/tj/Projects/connect 
/lib/middleware/logger.jJjs:155:5) 
at next {(/Users/tj/Projects/connect/l1ib/proto.js:179:15) 
at Function.handle (/Users/tj/Projects/connect/lib/proto.jJs:192:3) 
at Server.app {/Users/tj/Projects/connect/lib/connect.js:53:31) 
at Server.emit (events.js:67:17) 
at HTTPParser.onIincoming (http. js:1134:12) 
at HTTPPAarser.onHeadersComplete (http.]js:108:31) 
at Socket.ondata (http.js:1029.:22) 
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4. 接收 JSON 错 误 响 应 
如 果 你 发 送 的 HTTP 请 求 带 有 HTTP 请 求 尖 Accept: application/json， 会 得 到 下 面 的 
JSON 响 应 : 


S_ curl http://localhost/ -H "Accept: application/]jsonn 

{"error":{"stack": "Error: something broke!\n 
at Object.handle (/Users/tj/Projects/node-in-action 
/source/connect-middleware-errorHandler.js:12:10)\n 
at next (/Users/tj/Projects/connect/l1ib/proto.jJs:179:15) \n 
at Object.logger [as handle] (/Users/tj/Projects 
/connect/lib/middleware/logger.jJs:155:5) \n 
at next (/Users/tj/Projects/connect/l1ib/proto.js:179:15) \n 
at Function.handle (/Users/tj/Projects/connect/l1ib/proto.js:192:3) \n 
at Server.app (/Users/tj/Projects/connect/l1ib/connect.jJs:53:31) \n 
at Server.emit (events.js:67:17) \n 
at HTTPParser.onIncoming (http.jJs:1134:12) \n 
at HTTPParser.onHeadersComplete (http.js:108:31) \n 
at Socket.ondata (http.js:1029:22)","message'":"something broke!"}} 


我 们 已 经 对 JSON 吧 应 做 了 额外 的 格式 化 处 理 ， 这 样 看 起 来 更 清晰 ， 但 Connect 发 送 的 JSON 
啊 应 很 紧凑 ， 是 经 过 JSON .stringify () 处 理 的 。 

觉得 目 己 是 Connect 安 全 高 手 了 吗 ? 或 许 还 不 是 ， 但 你 应 该 已 经 掌握 了 足够 的 基础 知识 ， 可 
以 用 Connect 目 带 的 中 则 件 保证 程序 的 安全 。 接 下 来 我 们 要 介绍 一 个 非常 第 见 的 Web 程 序 功能 : 提 
供 静 态 文 件 服务 。 


7.4 提供 静态 文件 服务 的 中 间 件 


提供 静态 文件 服务 是 另 一 个 很 多 Web 程 序 需要 ， 但 Node 核 心 没 有 提供 的 功能 。 不 过 Connect 
帮 你 做 好 了 。 

你 在 本 市 中 又 要 学 习 三 个 Connect 目 市 的 中 间 件 , 这 次 主要 是 用 于 返回 来 目 文 件 系统 的 文件 ， 
很 像 普 通 的 HITP 服 务 需 做 的 那样 : 

D static() 将 文件 系统 中 给 定 根 目录 下 的 文件 返回 给 客户 端 ; 

口 compzress() 压缩 啊 应 ， 很 适合 跟 static() 一 起 使 用 ; 

D airectory() 当 请 求 的 是 目录 时 ， 返 回 那 个 目录 的 列表 。 

我 们 先 癌 你 介绍 如 何 便 助 static 组 件 用 一 行 代码 提供 静态 文件 服务 。 























7.4.1 static(): 静态 文件 服务 


Connect 的 static() 中 间 件 实现 了 一 个 高 性 能 的 、 灵 活 的 、 功 能 丰 宇 的 静态 文件 服务 种， 文 
持 HITP 绥 存 机 制 、 范 围 请 求 等 。 更 重要 的 是 ， 它 有 对 恶意 路 径 的 安全 检查 ， 默 认 不 允许 访问 隐 
藏 文件 (文件 名 以 .开头 )， 会 拒绝 有 害 的 null] 字 节 。static() 本 质 上 是 一 个 非常 安全 的 、 完 全 能 
胜任 的 静态 文件 服务 中 间 件 ， 可 以 保证 跟 目 前 各 种 HTTP 客 户 并 的 莱 容 。 
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1. 基本 用 法 

假定 你 的 程序 遵循 典型 的 场景 ， 要 返回 . /public 目 录 下 的 静态 资源 文件 。 这 可 以 用 一 行 代 
人 码 实 现 : 

app.use (connect.static{'public')); 

按照 这 个 配置 , static() 会 根据 请 求 的 URL 检 查 . /pupblic/ 中 的 普通 文件 。 如 果 文 件 存在 ， 
啊 应 中 content-Type 域 的 值 默认 会 根据 文件 的 扩展 名 设 定 ， 并 传输 文件 中 的 数据 。 如 果 被 请 求 
的 路 径 不 是 文件 ， 则 调用 next () ， 让 后 续 的 中 间 件 (如 果 有 的 话 ) 处 理 该 请 求 。 

我 们 来 测试 一 下 , 创建 一 个 名 为 . /public/foo0.js 的 文件 , 其 内 容 为 console.1log('tobi' )， 
用 带 -i 标 记 的 curl (1) 问 服务 右 发 送 请 求 ， 告 诉 它 输出 HTTP 响 应 头 。 你 会 看 到 正确 设 定 的 与 绥 
存 相 关 的 HTTP 啊 应 尖 ， 反 映 .js 扩展 名 的 content-Type， 以 及 传 过 来 的 内 容 : 


$ curl http://localhost/foo.js -i 

HITTP/1.1 200 OFK 

Date: Thu, 06 Oct 2011 03:06:33 GMT 
Cache-Control: public, max-age=0 
Last-Modified: Thu, 06 Oct 2011 03:05:51 GMT 
ETag: "21-1317870351000" 

Content-Type: application/javascript 








Accept-Ranges: bytes 
Content-Length: 21 
Connection: keep-alive 


console.1log('tob1i').; 

因为 请 求 路 人 径 就 是 当 作 文件 路 径 用 的 ， 所 以 在 目录 内 层 的 文件 也 能 按 你 期 望 的 那样 访问 。 比 如 
谨 你 的 服务 硕 上 可 能 收 到 了 一 个 GET / ]avaScr1lptSs/]Jduexry.] s 请 求 和 一 个 GET /stylesheets/ 
app. css 请 求 ， 它 会 分 别 返 回 . /public/javascripts/jquery.js 和 . /public/stylesheets/ 
app.css 文 件 。 

2. 使 用 带 挂 载 的 static() 

有 时 程序 会 用 /public、/assets 和 /static 之 类 的 路 径 做 前 缀 路径 名 。Connect 中 有 挂 载 
的 概念 ， 可 以 从 多 个 目录 中 提供 静态 文件 。 只 需 把 程序 挂 载 到 你 想 要 的 位 置 。 我 们 在 第 6 章 讲 过 ， 
中 间 件 本 刁 不 知 掉 它 是 从 哪里 排 载 的 ， 因 为 前 缀 被 去 反 卫 。 

比如 说 ， 请 求 GET /app/files/js/jquery .js 对 挂 载 在 /app/files 上 的 static() 来 说 
就 相当 于 GET /js/jquery。 这 能 很 好 地 实现 前 级 功能 ， 因 为 前 级 的 /app/files 不 会 出 现在 文 
件 路 径 解 析 中 : 

app.usel'/app/files', connect.static('public')); 

原来 那个 请 求 GET /foo.js 不 能 用 了 。 因 为 请 求 中 没有 出 现 挂 载 点 ， 所 以 中 间 件 不 会 被 调 
用 ,但 带 前 级 的 请 求 GET /app/filesy/foo.js 会 得 到 这 个 文件 : 


$s curl http://localhost/foo.]s 
Cannot get /foo.,js 

















$s curl http://localhost/app/files/foo.js 
console.log('tobi'); 
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3. 绝对 与 相对 目录 路 径 

请 记 住 传 到 static() 中 的 路 径 是 相对 于 当前 工作 目录 的 ,也 就 是 说 将 "public" 作 为 路 径 传 
人 会 被 解析 为 process.cwd() + "public"。 

然而 有 时 你 可 能 想 用 绝对 路 径 指 定 根 目录 ， 变 量 _dqirname 可 以 玫 你 达成 这 一 目的 : 

app.use('/app/files'，connect.static( _dirname + '/public')); 

4. 请 求 目录 时 返回 index.html 

static() 还 能 提供 index.html 服 务 。 当 请 求 的 是 目录 , 并 且 那 个 目录 下 有 index.html 时 ,， 它 可 
以 返回 这 个 文件 作为 啊 应 。 

现在 你 用 一 行 代码 就 可 以 提供 静态 文件 服务 了 , 接 下 来 我 们 去 看 看 如 何 用 中 间 件 compress () 
压缩 啊 应 数据 ， 以 减少 传输 的 数据 量 。 








7.4.2 compress(): 压缩 静态 文件 


zlib 模 块 给 开发 人 员 提 供 了 一 个 用 gzip 和 deflate 压 缩 及 解压 数据 的 机 制 。Connect2.0 及 以 上 版 
本 在 HITTP 服 务 需 层面 提供 了 zlib， 用 compress () 中 间 件 压缩 出 站 数据 。 

compress () 组 件 通过 请 求 头 域 Accept-Encoding 目 动 检测 客户 端 可 接受 的 编 权 .如 东 请 求 
头 中 没有 该 域 , 则 使 用 相同 的 编码 , 也 就 是 说 不 会 对 啊 应 做 处 理 。 如 果 请 求 头 的 该 域 中 包含 gzip、 
deflate 或 两 个 部 有 ， 则 啊 应 会 被 压缩 。 

1. 基本 用 法 

在 Connect 组 件 栈 中 ， 一 般 应 该 尽量 把 compress () 放 在 罪 上 的 位 置 ， 因 为 它 包 者 res .write() 
和 res .end () 方 法 。 

在 下 面 这 个 例子 中 ， 毅 态 文 件 服 务 将 会 文 持 数据 的 压缩 处 理 : 


Var connect = requirel('connect'); 























var Aapp = connectr) 
.USe {connect.compress()) 
.Use lconnect.static('source')).; 


app.l1isten{(3000);，} 
在 下 面 这 段 代码 中 ， 呵 应 返回 了 一 个 189 个 字 市 的 小 JavaScript 文 件 。 默认 的 curl1(1) 请 求 不 
会 发 送 Accept-Encoding 域 ， 所 以 你 收 到 的 是 普通 文本 : 


$ curl http://localhost/script.jJs -i 
HITTP/1.1 200 OFK 
Date: Sun, 16 Oct 2011 18:30:00 GMT 


Cache-Control: public, max-age=0 
Last-Modified: Sun, 16 Oct 2011 18:29:55 GMT 
ETag: "189-1318789795000" 

Content-Type: application/javascript 
AcCCept-Ranges: bytes 

Content-Length: 189 

Connection: keep-alive 
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console.log{('tobi')}):; 


console.log('loki'): 
console.log{('jane’'); 
console.logt'tobi'):; 
console.log{t'loki').; 


下 








console.log{('jane' 
( 
( 
( 


) 
Console.log('tobi').;: 
console.log('l]oki').;: 
console.]log{('jane’'); 


下 面 的 curl (1) 命令 加 上 了 Accept-Encoding 域 指明 它 能 接受 gzip 压 缩 的 数据 。 如 你 所 
匈 ， 即 便 这 人 么 小 的 文件 ， 因 为 数据 重复 度 十 分 局 ， 经 过 压缩 后 传输 的 数据 也 会 明显 减少 : 


$ curl http://localhost/script.jJs -i -H "Accept-Encoding: gzZip" 
HTTPE/1.1 200 OFK 

Date: Sun, 16 Oct 2011 18:31:45 GMT 
Cache-Control: public, max-age=0 
Last-Modified: Sun, 16 Oct 2011 18:29:55 GMT 
ETag: "189-1318789795000" 

Content-Type: application/Javascript 
AccCept-Ranges: bytes 

Content-Encoding: gzZip 

Vary: Accept-Encoding 

Connection: keep-allive 

Transfer-Encoding: chunked 








你 可 以 用 Accept-Encoding: deflate 再 试 一 次 。 

2. 使 用 定制 的 过 滤器 函数 

compress () 默认 支持 的 MIME 类 型 有 text/*、*/json 和 */javascript， 这 是 在 默认 的 
filtez 六 数 中 定义 的 : 

exports.filter = function(regq, res})t{ 


Var type = res.getHeader('Content-Type') || ''; 
return type.match(/json|text|javascript/); 





}; 
要 改变 这 种 行为 ， 可 以 在 选项 对 象 中 传人 一 个 filter， 像 下 面 这 段 代 码 中 这 样 ， 只 压缩 普 
通 文本 : 


function filter{lreg) { 





var type = req.getHeader('Content-Type') || ''; 
return 0 == type.indexOf ('text/plain'); 
} 


connect{() 
.USe{connect.comporess({ filter: fijlter })) 


3. 指定 压缩 及 内 存 水 平 

Node 的 zlib 模 块 提供 了 调整 性 能 和 压缩 特性 的 选项 ， 并 且 它 们 可 以 传 给 compress () 函数 。 

在 下 面 这 个 例子 中 ，1level1 被 设 为 ?， 压 缩水 平 更 低 但 更 快 ，memLevel1 被 设 为 8， 使 用 更 多 
内 存 加 快 压缩 速度 。 这 些 值 完 全 取决 于 你 的 程序 和 可 用 的 资源 。 请 参考 Node 的 zlib 文 件 了 解 详 情 : 
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Connectt) 


.USeE{(cCconnect.comress({ level: 


Connect 自 市 的 中 间 件 


3, memLevel: 


0 


接 下 来 是 directory () 中间 件 ， 它 可 以 帮 static() 提 供 各 种 格式 的 目录 列表 。 


1.4.3 directory (): 


目录 列表 


Connect 的 directory () 是 一 个 提供 目录 列表 的 小 型 中 间 件 ， 用 户 可 以 用 它 浏览 远程 文件 。 
图 7-$ 展 示 了 这 个 组 件 提 供 的 界面 ， 有 完整 的 搜索 输入 框 、 文 件 图 标 和 可 点 击 的 面包 屑 导航 。 


四 日 日 


4 listing directory /images 


“一 他 | © local:3000/images 





/ images 


assignment-points- 
attendance-msg- 
attendance-remove- 
attendance-search- 
back_arrow.png 
bg.grid.png 
btn.remove.pno 
button-fullscreen- 
button-paginate- 
button-settings.png 


calendar-event- 


图 7-5 ”用 Connect 的 directoryO 中 间 件 提供 目录 列表 服务 


1. 基本 用 法 


action_ button- 
attendance-back.png 
attendance-print- 
attendance-remOve- 
attendance-select.png 
bar-black-big.png 
borrowed.pna 

button- 
button-fullscreen.png 
button-paginate-right- 
buttons_raf.png 


calendar-Ooogle- 


admin-gapps- 
attendance-modal.png 
attendance-print- 
attendance-rollover.png 
autocomplete- 
bg-texture.png 
btn.remove-hover.png 
button-arrow-down.png 
button-paginate-left- 
button-paginate- 
calendar-arrows.png 


calendar-sync.png 





这 个 组 件 要 配合 static() 使 用 ， 由 static() 提 供 真正 的 文件 服务 ， 而 directory () 只 是 
提供 列表 。 其 设置 可 能 像 下 面 的 代码 这 样 从 单 ， 请 求 GET /会 得 到 ./public 目 录 的 列表 : 


var Connect = require('connect').; 


Var app = connect') 


.USe (connect .directory ('pPublic')) 
.USe (connect.static('pPublic'))}).,; 


app.listen{({3000); 
2. 使 用 带 挂 载 的 airectory () 


通过 中 间 件 挂 载 ， 你 可 以 给 directory () 和 static() 中 间 件 加 上 任何 你 想 要 的 路 径 做 前 
级 ， 比 如 下 例 中 的 cET /files。 这 里 的 选项 icons 用 来 启用 图 标 ，hiaaen 表 明 两 个 组 件 都 可 


以 查看 并 返回 隐藏 文件 : 
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Var app = connect() 
.use('/files', connect.directory('public', 
{ licons: true, hidden: true })) 
.USse(l'/files', connect.static('public', { hidden: true })}); 


app.listen(3000}).; 


现在 可 以 轻松 地 在 文件 和 目录 中 导航 了 。 








7.5 小结 


Connect 的 强大 之 处 在 于 它 丰 军 的 可 重用 目 市 中 间 件 ， 像 会 话 管 理 、 强 健 的 静态 文件 服务 ， 
出 站 数据 压缩 等 等 各 种 笛 见 的 Web 程 序 功能 它 都 有 实现 .Connect 的 目标 是 提供 一 些 开 箱 即 用 的 功 
能 ， 这 样 大 家 就 不 用 为 自己 的 程序 或 框 染 重复 编写 相同 的 代码 了 ( 可 能 效率 更 低 )。 

通过 这 一 章 的 学 习 , 你 已 经 看 到 了 ，Connect 完 全 可 以 用 中 间 件 的 组 合 构建 整个 Web 程 序 。 但 
Connect 一 般 用 来 作为 更 高 层 框 染 的 构件 。 比 如 说 ， 它 没有 提供 任何 路 由 或 模板 辅助 。Connect 的 
底层 方式 使 得 它 非常 适合 做 高 层 框架 的 基础 ，Express 就 是 这 样 集成 它 的 。 

你 可 能 在 想 ， 为 什么 不 能 只 是 用 Connect 构 建 Web 程 序 呢 ? 那 非常 有 可 能 ， 但 高 层 Web 框 架 
Express 充 分 利用 了 Connect 的 功能 ， 并 让 程序 开发 更 进一步 。Express 让 程序 开发 变 得 更 快 ， 更 有 
趣 ,， 它 有 优雅 的 视图 系统 、 强 大 的 路 由 ， 还 有 几 个 跟 请 求 和 响应 相关 的 方法 。 下 一 童 我 们 就 要 探 
索 Express。 
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EXxpress 





本 章 内 容 

口 开始 一 个 新 的 Express 程 序 
口 配置 你 的 程序 

口 创建 Express 视 图 

口 处 理 文 件 上 传 和 下 载 





事情 即将 变 得 更 加 有 趣 。Web 框 架 Express (http:/expressjs.com ) 是 构建 在 Connect 之 上 的 ， 
它 提 供 的 工具 和 结构 让 编写 Web 程 序 变 得 更 容易 、 更 快速 、 更 有 趣 。 Express 提 供 了 统一 的 视图 系 
统 ， 你 几乎 可 以 使 用 任何 你 想 用 的 模板 引擎， 还 有 一 些小 工具 , 让 你 可 以 用 各 种 数据 格式 返回 响 
应 ， 实 现 传送 文件 ， 路 由 URL 等 各 种 功能 。 

跟 Django 或 RoR 之 类 的 框架 比 起 来 , Express 非 党 小 。Express 的 主导 思想 是 程序 的 需求 和 实现 
变化 非常 大 ， 使 用 轻 量 的 框架 可 以 打造 出 你 恰好 需要 的 东西 ， 不 会 引入 任何 你 不 需要 的 东西 。 
Express 和 整个 Node 社 区 都 致力 于 做 出 更 小 的 ， 模 块 化 程度 更 高 的 功能 实现 ， 而 不 是 一 个 整体 式 
框架 。 

本 章 会 教 你 如 何 用 Express 构 建 程序 , 我 们 以 一 个 照片 分 享 程序 为 例 , 把 整个 构建 过 程 从 头 到 
尾 介绍 一 这。 在 这 个 过 程 中 ， 你 将 学 会 如 何 完成 下 述 任务 : 

口 生成 程序 的 初始 结构 ; 

口 配置 Express 和 你 的 程序 ; 

口 演 染 视图 ， 集 成 模板 引擎 ，; 

口 处 理 表 单 和 文件 上 传 ; 

口 处 理 资源 下 载 。 

这 个 照片 存储 程序 最 后 会 有 一 个 看 起 来 如 图 8-1 所 示 的 列表 视图 。 

还 会 有 一 个 用 来 上 传 新 照片 的 表单 ， 如 图 8-2 所 示 。 

最 后 会 有 一 种 下 载 照片 的 机 制 ， 如 图 8-3 所 示 。 
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Photos ~ Mozilla Firefox 
2) | Photos 


< localhost;3000 


Photos 


Express stock photo application. 


Nodejs Logo Ryan Speaking 


Nn de 





图 8-1 照片 列 表 视 图 


Photo Upload - Mozilla Firefox 
把 | Photo Upload 


4 localhost:3000/\ 


[ 
F 


Photo Upload 


Upload a photo to your account below. 


Browse... 





Upload 


图 8-2 ”照片 上 传 视 图 


download (JPEG Image, 2560 x 1702 pixels) - Scaled (22%) - Mozilla Firefox 


DD | 5 download UPEG Image... |+ 


< localhost:3000/photo/S08b52blef7! 





图 8-3 ”下 载 文 件 


图 灵 社 区 会 员 quqingtao 专 享 尊重 版 权 


160 第 8 章 ”Express 
我 们 先 从 程序 的 结构 开始 入 手 吧 。 


8.1 生成 程序 骨架 


月 

Express 不 会 在 程序 结构 上 强迫 开发 者 , 你 可 以 把 路 由 放 在 任意 多 的 文件 中 , 公共 资源 文件 也 

可 以 放 到 任何 目录 下 , 等 等 。 最 小 的 Express 程 序 可 能 像 下 面 代码 清单 中 的 这 样 小 , 但 也 是 一 个 功 
能 完备 的 HTTP 服 务 器 。 


代码 清单 8-1 最 小 的 Express 程 序 














Var express = redulrel(' express') ，; 
Var app = express(); ee 
响应 对 /的 请 求 
app.get('/', functionl(req, res)t 
-eseSeng( ”Hello' ys 、、 
上 发 送 “Hello” 作 为 响应 文本 
abs. Listen(3000}); < 一 监听 端口 3000 


Express 中 有 可 执行 的 express (1) 脚本， 它 能 帮 你 设置 程序 的 骨架 。 如 果 你 刚 接触 Express， 
用 生成 的 程序 起 步 是 个 好 办 法 ,因为 它 帮 你 设置 了 程序 的 模板 、 公 共 资 源 文 件 、 配 置 等 等 很 多 东西 。 

express (1) 生 成 的 程序 只 有 几 个 目录 和 文件 ， 如 图 8-4 所 示 。 设计 成 这 样 的 结构 是 为 了 让 开 
发 者 在 几 秒 钟 之 内 就 可 以 把 Express 跑 起 来 ,但 你 和 你 的 团队 完全 可 以 目 行 创建 程序 的 结构 。 











wavded@dev:~/Projects/photo 


app. ]js 
package. json 
public 


images 
javascripts 
stylesheets 


style.css 
routes 


全 index. js 
User.]s 
views 
[一 index.ejs 
6 directories, 6 files 


[wavded@dev photo]$ _ 


图 8-4 ”使 用 EJS 模 板 的 默认 程序 骨架 结构 


在 本 和 草 的 例子 中 , 我 们 使 用 的 模板 是 EJS, 它 的 结构 跟 HTML 很 像 。EJS 类 似 于 PHP、JSP (在 
Java 中 用 ) 和 ERB (在 Ruby 中 用 )， 服 务 器 端 JavaScript 瞬 在 HTML 文档 中 ， 在 发 送 到 客户 端 之 前 
执行 。 我 们 在 第 11 章 还 会 详细 讨论 EJS。 

到 本 董 结束 时 ， 你 会 有 一 个 结构 类 似 但 做 了 些 扩展 的 程序 ， 如 图 8-5 所 示 。 
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wavded@dev: ~/Projects/photo 


app. js 
models 
-一 Photo. js 
package. json 
public 


images 
javascripts 
photos 
stylesheets 


[一 style.css 
routes 
|- 一 photos. js 
views 
-一 photos 


EE index.ejs 
upload.ejs 


9 directories, 7 files 
wavdede@ ~/Projects/photo» 


图 8-5 ”程序 最 终 的 结构 


本 市 会 市 你 完成 如 下 任务 : 
口 用 npm 安 竣 全 局 Express; 
口 生成 程序 ; 

口 探索 程序 并 安 疙 依赖 项 。 
让 我 们 开始 行动 吧 !1 





.1 安装 Express 的 可 执行 程序 
首先 要 用 npm 安 装 全 局 的 Express: 


$s npm install -gq express 


装 好 之 后 ， 你 可 以 用 --help 标 记 看 看 可 用 的 选项 ， 如 图 8-6 所 示 。 





wavded@dev:"/Projects/photo 
[wavdededev photo]$ express --help 


Usage: express [options] 


Options : 
-h，--help output Usage information 
-V，--Vversion output the version number 
-S，--Sessions add session support 
-e, --e]js add ejs engine support (defaults to jade) 
-J, -=jshtml add jshtml] engine support (defaults to jade) 
-H，--hogan add hogan.js engine support 
-C，--CcSsSs <engine> add stylesheet <engine> Support (less|stylus) (defaults to plain c 
ss) 
-ff =--force force on non-empty directory 


[wavdededev photo]$ _ 


图 8-6 Express 帮助 


图 灵 社 区 会 员 quqingtao 专 享 尊重 版 权 


162 第 8 章 ”Express 


其 中 一 些 选项 会 帮 你 生成 程序 中 的 某 些 部 分 。 比 如 说 ,你 可 以 指定 模板 引擎， 让 它 生 成 选 定 
模板 引擎 的 空 模板 文件 。 类 似 地 ， 如 果 你 用 --css 选 项 指定 了 CSS 预 处 理 器 ， 它 会 为 你 生成 选 定 
CSS 预 处 理 需 的 资源 文件 。 如 果 你 使 用 --sessions 选 项 ， 它 会 局 用 session 中 间 件 。 

可 执行 程序 装 好 后 ， 接 下 来 我 们 要 生成 最 终 会 变 成 上 照片 程序 的 程序 骨架 。 


8.1.2 生成 程序 


要 使 用 EJS 模 板 引 擎 ， 需 要 指定 -e (或 --ejs ) 标记 ， 执 行 express -e photo。 
一 个 功能 完备 的 程序 会 出 现在 photo 目 录 中 。 其 中 会 有 一 个 描述 项 目 和 依赖 项 的 package.json 
文件 ， 程 序 文件 本 身 ，public 文 件 目录 ， 以 及 一 个 放 路 由 的 目录 ( 见 图 8-7 )。 











wavded@dev:~*/Projects 


[wavded@dev Projects]$ express -~e photo 
create : photo 
create : photo/package.]json 
create : photo/app.]js 
create : photo/public 
create : photo/public/javascripts 
create : photo/public/images 
create : photo/routes 
create : photo/routes/index.]js 

reate : photo/routes/user.]js 

create : photo/views 

reate : photo/views/index.ejs 

reate : photo/public/stylesheets 

reate : photo/public/stylesheets/style.css 


install dependencies: 
$ cd photo && npm install 


run the app: 
$ node app 


[wavded@dev Projects]$ _ 


图 8-7 ”生成 Express 程 序 


8.1.3 ”探索 程序 


我 们 来 仔细 看 一 下 生成 了 什么 东西 。 在 编辑 侣 中 打开 package.json 文 件 ， 看 看 程序 的 依赖 项 ， 
如 图 8-8 所 示 。Express 猿 不 出 你 要 用 依赖 项 的 哪个 版 本 ， 所 以 你 最 好 给 出 模块 的 主要 、 次 要 及 修 
订 版 本 号 ， 以 免 引 入 意料 之 外 的 bug。 比 如 明确 给 出 "express":"3.0.0"， 那 么 每 次 安装 时 都 
会 给 你 提供 相同 的 代码 。 

要 添加 模块 的 最 新 版 ， 比 如 这 里 的 EJS， 可 以 在 安装 时 给 npm 传 入 --save 标 记 。 执 行 下 面 的 
命令 ， 再 次 打开 package.json， 看 看 它 有 什么 变化 : 

$ npm install ejs --save 

现在 看 一 下 express (1) 生 成 的 程序 文件 ， 在 下 面 的 代码 清单 中 。 暂 时 先 不 要 动 它 。 其 中 的 
中 间 件 在 Connect 那 一 曹 都 介绍 过 了 ， 但 这 个 文件 还 是 值得 一 看 ， 我 们 可 以 看 看 默认 的 中 间 件 配 
置 是 如 何 设置 的 。 
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8.1 生成 程序 


wavded@dev:~/Projects/photo 


[wavded@dev Projects]$ cd photo 
[wavdededev photol]$ cat package. jsSon 


{ 


“name”: 


"application-name”, 


"version"”: "0.0.1",， 
"private"”: true, 
Te 

"start”: “node app” 


"dependencies"”: { 
"express": "3.0.0", 


hy i 


对 LL 
大 


】} 
[wavdededev photo]$ _ 


图 8-8 ”生成 的 package.json 中 的 内 容 


代码 清单 8-2 ”生成 的 Express 程 序 骨 染 


Var express = require!('express') 
routes = require{(',./routes') 
; USer = require!('./routes/user') 
， http = reguirel(l'http') 
; Path = require!( 'path').: 





var app = express{(}):; 


app.configure{({function{(}t 


局 下 站 >) 。 
QPb. 
QPb. 
app. 
app. 


app 
7 门 上 二、 主 < 


主体 app.use (app.router); 
app.use (express.static (path.join dirname, 'public'! p 
是 u XD LO on( 局 Bullnue yy) 提供 ./public 下 
' 的 静态 文件 
app.configure('development', function()t 
app.use (express.errorHandler F ce 
I . 在 开发 时 显示 样式 化 的 
HTML 错 误 页 面 
app.get('/', routes.index).; 
' ' ; 指定 程序 路 由 
app.get('/users', user.11i1st).,， 目 征 枉 仓 
http.createServer (app) .listen(app.get('port'), function()t 
console.1log ("Express server listening on port " + app.get('port' 
}); 





set('port', process.env.PORT || 3000); 
set{'views', dirname + '/views').; 
set{'view engine', 'ejs'); 

use (express, favicon()).: < 一 提供 默认 的 favicon 


use (express.logger('dev')); 


.USe (express.methodOverride()); 





你 已 经 得 到 了 package.json 和 app.js 文 件 ， 但 程 因为 你 还 没 


express ( 1 什 么 时 候 生 成 package.json 文 件 ， 你 都 需 


1 得 宫 上 从 | 1 安装 志 依 赖 项 


看 程序 。 霓 认 的 程序 看 起 来 像 图 8- 10 一 样 。 





看 完 生成 的 程序 ， 接 下 来 我 们 要 深入 到 特定 环境 下 的 配置 中 去 。 
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=™h 
久 


疙 依赖 项 呢 。 不 省 
装 依赖 项 ( 如 图 8-9 所 示 )。 执 行 npm 
， 然 后 执行 hode app. 人 | 览 器 中 访问 http:/localhost:3000 查 
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( 
( 
( 

.USE es .bodyParser () ) ; 输出 有 颜色 区 分 的 日 志 ， 
( 以 便于 开发 调试 
( 
( 
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wavded@dev:*/Projects/photo 


Lwavded@dev photoj$ npm install 
ejs@0.8.3 node_modules/ejs 


express@3.0.0 node_modules/express 

methodse6.0.1 

fresheo.1.0 

range-parser@0.0.4 

cookie@0.0.4 

crc@0.2.0 

commander@0.6.1 

debugeo.7.0 

mkdirpeo.3.3 

sende@o.1.0 (mime@]1.2.6) 

connecte2.6.0 (pause@0.0.1, bytes®@0.1.0, formidable@]1.0.11, qs@0.5.1, send@0.0.4) 
[wavded@dev photo]$ node app.js 
Express server listening on port 3000 


图 8-9 安装 依赖 项 并 运行 程序 


Express ~ Mozilla Firefox 





名 | 人 Express | 二 
《 localhost 
Express 


Welcome to Express 


图 8-10 ”默认 的 Express 程 序 


8.2 配置 Express 和 你 的 程序 


程序 的 第 求 取决 于 它 所 运行 的 环境 。 比 如 说 ， 当 你 的 产品 处 于 开发 环境 中 时 ,你 可 能 想 要 详 
尽 的 日 志 ， 但 在 生产 环境 中 ， 你 可 能 想 要 精简 的 日 志和 gzip 压 缩 。 除 了 配置 特定 环境 下 的 功能 ， 
你 可 能 也 想 定义 一 些 程序 层面 的 设 定 , 以 便 让 Express 知 道 你 用 的 是 什么 模板 引擎 , 以 及 到 哪里 去 
找 模板 。Express 还 允许 你 定义 定制 的 配置 键 / 值 对 。 

Express 有 一 个 极 简 的 环境 驱动 配置 系统 ， 由 5 个 方法 组 成 ， 全 部 由 环境 变量 NODE_ENV 了 驱动 : 

app.configure!() 





Dapp.set() 

UD app.get() 

Dapp.enable() 

UD app.disable() 

在 本 节 中 , 你 将 会 看 到 如 何 用 配置 系统 定制 Express 的 行为 , 以 及 如 何 依照 你 的 目的 在 开发 过 
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程 中 使 用 它 。 
我 们 先 认真 探讨 一 下 “基于 环境 的 配置 ”意味 者 什么 。 





要 在 UNIX 中 设置 环境 变量 ， 可 以 用 这 个 命令 : 
S NODE ENV=production node app 

在 Windows 中 用 这 个 : 

S Set NODE ENV=production 


$ node app 
这 些 环境 变量 会 出 现在 你 程序 里 的 process .env 对 象 中 。 


基于 环境 的 配置 


尽管 环境 变量 NODE_ENV 源 日 Express, 但 现在 很 多 Node 框 架 都 用 它 通知 Node 程 序 它 在 什么 环 
境 中 ， 黑 认为 开发 环境 。 

如 代码 清单 8-3 所 示 ，app .configure() 方 法 接受 一 个 表示 环境 的 可 选 字 符 串 ,以 及 一 个 也 
数 。 当 环境 与 传人 的 字符 串 相 匹 配 时 ,回调 函 数 会 彼 立 即 调 用 ; 当 只 给 出 孙 数 时 ,在 所 有 环境 中 
都 会 调用 它 。 这 些 环境 的 名 称 完全 是 随意 的 。 比如 说 ， 你 可 以 用 development、 stage, 七 es 
和 production， 或 位 写 为 prod。 











代码 清单 8-3 ”用 app .configure() 设 定 特定 环境 的 选项 


app.configure (function()t 


app.set('views', _ dirname + '/views'); < 一 所 有 环境 
app.set('view engine', 'ejs'); 

1 

app.configure('development', function()t 
DD .MSs (expbress .cerorniandler'()})’ < 一 仅 开 发 环境 


}); 
app.configure() 只 是 糖衣 ， 下面 这 段 代 人 码 和 前 面 那个 效果 是 一 样 的 。 你 不 是 必须 用 这 个 
特性 ， 比 如 说 ， 你 可 以 从 JSON 或 YAML 中 加 载 配 置 。 


代码 清单 8-4 ”用 条 件 判断 设 定 特 定 环 境 的 选项 








Var env = process.env.NODE ENV || 'development'; 
默认 为 “development” 
app.set('views', _ dirname + '/views'); 
app.set('view engine', 'ejs'); < 一 所 有 环境 
If ('development' == env) { 


仅 开 发 环境 ， 用 if 语 句 


app.use (express.errorHandler()).; = 


} 
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为 了 让 你 可 以 定制 Express 的 行为 ，Express 内 部 使 用 了 配置 系统 ,但 你 也 可 以 使 用 配置 系统 。 
本 章 要 构建 的 程序 只 有 一 个 设 定 项 ，photos， 它 的 值 是 一 个 目录 ， 用 来 存放 传 上 来 的 图 片 。 这 
个 值 在 生产 环境 中 可 以 修改 ， 以 便 在 有 更 多 便 盘 空间 的 卷 中 保存 和 提供 照片 : 


app.configure (function(}t 








apPD.SsSet{'photos', dirname + '/Public/photos'); 
1 
app.configure(l'production', function'()}t 
app.sett'pPhotos', '/mounted-volume/photos'); 


1 

Express 还 为 Boolean 类 型 的 配置 项 提供 了 app.set() 和 app.get() 的 变 体 。 比 如 说 ， 
app.enable (setting) 等 同 于 app .set (setting, true), app.enabled (setting) 可 以 用 
来 检查 该 值 是 否 局 用 了 。 app.dqisable(setting) 和 app.disabled(setting) 让 足 了 Boolean 
类 型 的 变 体 。 


看 完了 如 何 使 用 配置 系统 ， 接 下 来 我 们 去 看 看 Express 中 的 视图 演 染 。 











8.3” 演 染 视 医 


尽管 我 们 前 面 说 过 ， 几 乎 所 有 Node 社 区 中 的 模板 引擎 都 能 用 在 Express 中 ， 但 本 章 的 程序 用 
的 是 EJS 模 板 。 不 吕 悉 EJS 也 不 用 担心 ， 它 很 像 其 他 语言 (PHP、JSP、ERB ) 中 的 模板 语言 。 本 
章 只 是 介绍 一 些 EJS 的 基础 知识 ， 但 第 11 章 会 详细 介绍 EJS 和 其 他 几 个 模板 引擎 。 

不 管 是 演 染 整个 HTML 页 面 、 一 个 HTML 片 段 ， 或 者 一 个 RSS 预 订 源 ， 演 染 视 图 对 几乎 所 有 
程序 来 说 都 至 关 重 要 。 它 的 概念 很 简单 : 你 把 数据 传 给 视图 ， 然 后 数据 会 被 转换 ， 通常 是 变 成 
Web 程 序 中 的 HTML。 视图 的 概念 对 你 来 说 应 该 不 算 陌 和 后, 因为 大 多 数 框 架 都 提供 了 类 似 的 功能 。 
图 8-11 曾 明了 视图 如 何 形 成 新 的 数据 表示 。 

















{ name: 'Tobi', species: 'ferret', age: 2 } 


<h1>Tob1L</h1> 
<p>Tobt 1s a 2 year old ferret.</p> 


图 8-11 HTML 模 板 加 数据 = 数据 的 HTML 视 图 


Express 中 两 种 演 染 视图 的 办 法 : 在 程序 层面 用 app.render() ， 在 请 求 或 啊 应 层面 用 
res .render()， 它 在 内 部 用 的 也 是 前 者 。 本 章 只 用 res .render ()。 如 果 你 看 一 下 . /routes/ 
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8.3 泻 染 视图 167 


index.js， 会 看 到 一 个 输出 的 图 数 : indqex。 这 个 图 数 调用 res .render () ， 演 染 ./views/ 
index.ejs 模 板 ， 代 人 码 如 下 所 示 : 


exports.index = function(regq, res)})f 
res.render{'index', { title: 'Express'! }); 

ky 

在 本 节 中 ， 你 会 了 解 如 何 进行 下 列 操作 

口 配置 Express 视 图 系统 ; 

口 查找 视图 文件 ; 

口 在 演 染 视图 时 输出 数据 。 

在 认真 全 究 res .render () 之 前 ， 我 们 先 来 配置 视 网 系 统 。 








8.3.1 视图 系统 配置 


Express 视 图 系统 配置 起 来 很 简单 。 即便 sxpress(1) 帮 你 生成 了 配置 ， 你 还 是 应 该 知道 它 的 
底层 机 制 ， 这 样 才能 在 需要 时 修改 它 。 我 们 会 重点 介绍 三 个 领域 . 
口 调整 视图 的 查找 ; 
口 配置 默认 的 模板 引擎 ; 
口 局 用 视图 缓存 ， 减 少 文件 IO。 
首先 是 视图 的 设 定 。 
改变 查找 目录 
下 面 的 代码 片段 是 Express 的 可 执行 程序 创建 的 视图 设 定 : 
app.set('views', dirname + '/views'); 
这 个 指定 了 Express 在 查找 视图 时 所 用 的 目录 。 用 dirname 是 个 好 主意 ， 这 样 你 的 程序 就 不 
会 依赖 于 作为 程序 根 目 录 的 当前 工作 目录 。 
Gdirname 
Node 中 的 _dirname (前 面 有 两 个 下 划 线 ) 是 一 个 全 局 变量 ， 用 来 确定 当前 运行 的 文件 
所 在 的 目录 。 在 开发 时 ， 这 个 目录 通常 跟 你 的 当前 工作 目录 (CWD ) 是 同一 个 目录 ， 但 在 生 
产 环境 中 ，Node 可 能 是 从 另外 一 个 目录 中 运行 的 。 用 dirname 有 助 于 保持 路 径 在 各 种 环境 
中 的 一 致 性 。 























下 一 个 设 定 是 view engine。o 

默认 的 模板 引擎 

express(1) 生 成 程序 时 ，view engine 被 设 定 为 ejs 是 因为 命令 行 中 的 -e 选 项 选择 了 模板 
引擎 EJS。 这 个 设 定 让 你 可 以 在 泻 染 中 用 indqex， 不 用 index.ejs。 人 否则 ，Express 需 要 有 扩展 名 才能 
确定 用 哪个 模板 引擎 。 

你 可 能 在 想 Express 为 什么 还 要 考虑 扩展 名 。 因 为 有 了 扩展 名 可 以 在 一 个 Express 程 序 中 使 用 
多 个 模板 引擎 , 同时 又 能 给 常用 用 例 提 供 一 个 清晰 的 API, 因为 大 多 数 程序 都 是 用 一 个 模板 引擎 。 














图 灵 社区 会 员 quqingtao 专 享 尊重 版 权 





168 第 8 章 ”Express 


比如 说 ， 你 发 现 用 另外 一 种 模板 引擎 写 RSS 预 订 源 更 容易 ， 或 者 你 可 能 从 一 个 模板 引擎 迁移 
到 了 另 一 个 上 。 你 可 能 将 Jade 作 为 默认 引擎 ，EJS 用 于 /feed 路 由 ， 就 像 下 面 的 代码 清单 中 这 样 指 
明 .ejs 扩 展 名 。 


代码 清单 8-5 用 文件 扩展 名 指定 模板 引擎 
app.set('view endlne'，']jaaqe'):; 


app.get('/', function()t 
res.render('index').; 


}); 


会 假定 为 .jade， 因 为 它 被 设 定 为 view engine 


EO 关 因为 提供 了 扩展 名 .ejs， 所 以 会 用 模板 引擎 EJS 


res.render('rss.ejJs') 
}); 
让 package.json 保 持 同 步 ” 记 住 ， 你 想 用 的 任何 额外 模板 引擎 都 应 该 添加 到 
package.json 的 依赖 项 对 象 中 。 


生产 环境 中 会 默认 启用 view cache 设 定 ， 并 防止 后 续 的 render () 调用 执行 硬盘 IO。 模 板 
的 内 容 保存 在 内 存 中 , 性 能 会 得 到 显 若 提升。 局 用 这 个 设 定 的 副作用 是 只 有 重 局 服务 硕 才 能 让 模 
板 文件 的 编辑 生效 ， 所 以 在 开发 时 会 禁用 它 。 如 采 你 正 运行 在 分 级 ( staging ) 环境 中 ,很 可 能 
局 用 这 个 选项 。 

如 图 8-12 所 示 ， 在 view cache 被 禁用 时 ， 每 次 请 求 痢 会 从 便 盘 上 读 取 模板 。 这 样 你 无 需 重 
启程 序 就 可 以 让 模板 的 修改 生效 。 当 启用 view cache 时 ， 每 个 模板 只 会 读 取 一 次 硬盘 。 


Request Caching disabled 


(Request ) 
1 res.render{({'user', {name: 'Tobi'}) 


2 res.render{({'user', {name: 'Tobi'}) 





























Response 





攻 8-12” view cache 设 定 
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Reduest Caching enabled 











res.render{'user', {name: 'Tobli'}) 





1 















res.render{({'user', {name: 'Tobli'}) 


2 





图 8-12 view cache 设 定 ( 续 ) 


你 已 经 知道 视图 缓存 机 制 如 何 玫 助 提升 非 开 发 环境 中 的 程序 性 能 了 。 接 下 来 我 们 看 看 Express 
如 何 定 位 视图 来 演 染 它们 。 








8.3.2 ”视图 查找 


你 已 经 知道 如 何 配 置 视图 系统 了 , 现在 我 们 来 看 一 下 Express 是 如 何 查 找 视图 的 , 即 在 哪里 定 
位 目标 视图 文件 。 先 不 要 管 这 些 模板 的 创建 ， 你 后 面 会 做 的 。 

查找 视图 的 过 程 跟 Node 的 require() 工作 机 制 类 似 。 当 res .render() 或 app .render () 
被 调用 时 ,Express 会 先 检 查 是 否 有 文件 在 这 个 绝对 路 径 上 。 接 关 会 找 8.3.1 闻 讨论 的 视图 目录 设 定 
的 相对 路 径 。 最 后 ，Express 会 尝试 使 用 index 文 件 。 

这 个 过 程 如 图 8-13 中 的 流程 图 所 示 。 

因为 默认 的 引 敬 被 设 定 为 ejs， 所 以 render 会 忽略 .ejs 扩 展 名 ,但 它 仍 能 正确 解析 。 

随 奢 程序 的 不 断 进 化 ， 你 会 需要 更 多 的 视图 ， 并 有 旦 有 时 一 个 资源 需要 几 个 视图 。 用 view 
lookup 可 以 帮 你 组 织 这 些 视 图 ， 比 如 说 ,你 可 以 使 用 跟 资 源 相连 的 子 目录 ， 在 其 中 创建 视图 ， 
比如 图 8-14 中 的 photos 目 录 。 

添加 子 目录 可 以 去 掉 模 板 名 称 中 的 元 余部 分 比如 upload-photo . ©] s 和 show-photo .Ge]Sso 
Express 会 添加 view engine 扩 展 名 ， 将 视图 解析 为 . /views /photos/upload.e]jso。 

Express 会 检查 是 否 有 名 为 iIndex 的 文件 在 那个 日 录 中 。 当 文件 的 名 称 为 复数 时 ， 比 如 photos， 
通常 暗示 着 这 是 一 个 资源 列表 。 图 8-14 中 的 res .render ('photos') 就 是 这 样 的 例子 。 

你 已 经 知道 Express 是 如 何 查 找 视 图 的 了 ,那么 我 们 开始 创建 照片 列表 ,把 这 个 功能 用 起 来 吧 。 
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View render 
requested 


Does a file exist with an absolute path? 





Yes 





Ee 


No 





Does a file exist relative to the Processing view 


using file 


Views setting directory? 





No 
Does an index file exist? 
No 


图 8-13 ”Express 视 图 查找 过 程 


wavded@dev:~/Projects/photo 


Res.render views | 
(‘la out) index.ejs 
ay = layout.ejs 
photos 
| | p> index.ejs 
Res.render ' 广 upload.ejs 
(photos ) 


1 directory，4 files 
Res render [wavdededev photoj$ _ 


(photos/upload ) 


图 8-14 ”Express 视图 查找 
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在 Express 中 ， 要 把 本 地 变量 输出 到 被 浑 染 的 视图 有 几 种 办 法 ， 不 过 首先 要 有 可 泻 染 的 东西 。 
本 市 会 用 一 些 假 数 据 组 装 出 照片 列表 的 初始 视图 。 

我 们 暂时 先 不 引入 数据 库 ， 而 是 做 一 些 假 数据 。 先 创建 文件 .routes/photos.js， 其 中 包含 与 照 
片 相关 的 路 由 。 然 后 在 这 个 文件 中 创建 一 个 photos 数 组 ， 证 它 充当 我 们 的 临时 数据 库 。 代 码 如 下 
所 示 : 


代码 清单 8-6 ”组 北 视 图 的 虚假 照片 数据 
var photos = {1: 
photos.push!{t 
name: 'Node.Js Logo', 
path: 'http://nodejs.org/images/l1ogos/nodejs-green.png' 
站 








photos.pusht{t 

name: :Ryan Speaking’, 
path: ‘http://nodej]s.org/images/ryan-speaker .jpg 
了 7 





内 容 有 了 ， 还 需要 一 个 显示 它 的 路 由 。 








创建 照片 列表 视 
要 显示 这 些 照 厂 数 据 ， 需 要 先 定 义 一 个 路 由 去 泻 染 EJS 照 片 视图 ， 如 图 8-15 所 示 。 
Photos ~ Mozilla Firefox 
Ry | 舍 Photos | + 
< localhost;3000 
Photos 
Express stock photo application. 
Node.js Logo Ryan Speaking 
Nae 








图 8-15 ”照片 列表 的 初始 视图 


我 们 先 从 ./routes/photos.js 开 始 ， 打 开 这 个 文件 ， 输 出 函数 1ist (代码 在 下 面 的 清单 中 )。 实 
际 上 ， 你 可 以 按 自己 的 想法 命名 这 个 函数 。 路 由 函数 等 同 于 普通 的 Connect 中 间 件 函 数 ， 接 受 请 
求 和 啊 应 对 象 ， 以 及 next () 回调 ， 不 过 这 个 例子 中 没 用 。 把 对 和 象 传 给 res .render () 方 法 是 第 
一 种 ， 也 是 最 主要 的 癌 视 图 传递 数据 的 办 法 。 
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代码 清单 8-7 列表 路 由 

exports.list = function(req, res)t 

res.render{({'photos', { 
title: 'Photos', 

Photos: Photos 
0 
人 
然后 你 可 以 在 ./app.js 中 引入 photos 模 块 , 访问 你 刚刚 写 好 的 exports.1List 图 数 。 为 了 在 首 
页 /中 显示 照片 ， 要 把 photos .1ist 了 函数 传 给 app .get () 方 法 ， 它 会 把 路 径 / 上 的 HITP GET 方 法 


映射 到 这 个 函数 上 。 
代码 清单 8-8 添加 photos.list 路 由 








var routes = require('./routes'); 

var photos = require('./routes/photos').; 
. 替换 app.get(/, routes.index) 
app.get('/', photos.1ist).; 


数据 和 路 由 部 准 备 好 了 ,你 可 以 写照 厂 的 视图 了 。 跟 照片 有 关 的 视图 有 几 个 ， 所 以 我 们 要 创 
建 目录 ./views/photos， 并 在 里 面 放 一 个 index.ejs 文 件 。 你 可 以 用 JavaScript 的 forEach 循 环 遍历 传 
res .render() 的 photos 对 和 象 ,逐一 处 理 其 中 的 photo 显示 每 张 照片 的 名 称 和 图 片 ， 像 下 面 
的 代码 清单 中 那样 。 


代码 清单 8-9 ”照片 列 表 视 图 的 模板 


<1DOCTYPE html> 





< 了 tm > 

<head> _ EJS <%= value %> 输 出 转 义 的 值 
<title><%= title %></title> 
<link rel='stylesheet' href='/stylesheets/style.css' /> 

</head> 

<body> 
<hil>Photos</h1i> 
<p>Express stock photo application.</p> 
<div id="photos"> _ EJS 用 <% code %> 执 行 普通 的 JS 

<% photos.forEach (function(photo) { %> 


<div class="photo"> 
<h2><%=photo.name%></h2> 
<img src='<%=photo.path%>'/> 


</div> 

< 名 }})】 第 > 
</div> 
</body> 


</html> 
这 个 视图 会 产生 下 面 这 种 标记 。 
代码 清单 8-10 ”photos/index.ejs 模 板 产 生 的 HTML 


<hi>Photos</h1> 
<p>Express stock photo application.</p> 
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<div id="photos"> 
<div class="photo"> 
<h2>Node.]s Logo</h2> 
<img src="http://nodejs.org/images/logos/nodejs-green.png" /> 
</div> 





如 图 你 对 程序 的 样式 感 兴趣 ， 下 面 是 ./public/stylesheets/style.css 中 的 CSS 。 
代码 清单 8-11 本 草 的 教学 程序 中 所 用 样式 的 CSS 





body 1 
padding: 5Opx; 
font: 14Px "Helvetica Neue'", Helvetica, Arial, sans-serif,; 


} 

a { Color: #0OO0OB7TFF; } 

.photo { 
display: inline-block; 
margin: SpX; 
padding: 1l10px; 
border: lpx solid #eee; 
border-radius: SPpxX; 
box-shadow: 0 lpx 2px #ddd; 

} 

.bhoto h2 1{ 
margin: 0; 
margin-bottom: Spx; 
font-size: 14px; 
font-weight: 200; 

} 

.photo img { height: 100px; } 


用 node app 启 动 程序 ， 在 你 的 浏览 如 中 访问 http://localhost:3000。 你 会 看 到 之 前 在 图 8-15 中 
显示 的 照片 。 

将 0 到 视图 中 的 方法 

你 已 经 见 过 如 何 将 本 地 变量 量 佣 搂 传 从 res.render ( ) 了 了 ? 但 除 此 之 外 还 有 其 他 办 法 可 用 。 比 
如 用 app .1locals 传 递 程 序 层面 的 变量 ， 用 res .1ocals 传 递 请 求 层面 的 本 地 变量 。 

和 耳 接 传 给 res .render () 的 值 优先 级 要 高 于 通过 res .locals 和 app.1locals 设 定 的 值 ， 如 
图 8-16 所 示 。 

Express 默 认 只 会 回 视 网 中 输出 一 个 程序 级 变量 ，settings ， 这 个 对 象 中 包含 所 有 用 
app .set ( ) 设 定 的 值 。 比如 app .Set('title', 'My Application') 会 把 settings .title 


输出 到 模板 中 ， 请 看 下 面 的 EJS 代 码 卢 段 : 
<html> 

<head> 
<title><%S=-settings .titles></title> 

</head> 

<body> 
<hl><%=settings.title®S></hil> 
<p>Welcome to <%=-settings.titles>.</p> 

</body> 
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Variable found 
in template 


Found in values passed to render? 















Found in res .locals? 





A Return value 》 











Found in app. locals? 








No 
| Return error | 


图 8-16 ”在 演 染 模板 时 ， 下 接 传 给 render 函 数 的 值 优先 级 最 高 
从 Express 内 部 来 看 ， 它 是 用 下 面 的 JavaScript 输 出 这 个 对 象 的 : 
app.locals.settings = app.settinges; 
全 都 在 这 儿 了 。 


为 了 方便 ，app. locals 也 被 做 成 了 一 个 JavaScript 咖 数 。 当 有 对 象 传人 时 ， 所 有 的 键 都 会 被 
合并 ， 所 以 如 果 你 有 想 整 体 输出 的 对 象 ， 比 如 某 些 i18n 数 据 ， 可 以 这 样 做 : 





var il8n = f{ 
Prev: 'Prev', 
next: 'Next', 
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app.locals (il8n); 

这 样 会 把 prev、next 和 save 输 出 到 所 有 模板 中 ,我 们 可 以 用 这 个 特性 输出 视图 的 辅助 函数 ， 
从 而 减少 模板 中 的 逻辑 。 比 如 说 ， 如 有 果 你 有 一 个 输出 了 几 个 函数 的 Node 模 块 helpers .js， 可 以 
像 下 面 这 样 把 所 有 孔 数 输出 到 视图 中 : 

app.locals{require('./helpers'})); 


接 下 来 我 们 要 给 这 个 网 站 添加 一 个 文件 上 传 的 功能 ， 并 学 习 一 下 Express 如 何 使 用 Connect 的 
中 间 件 bodyParser 实 现 这 一 功能 。 


8.4 处理 表单 和 文件 上 传 


接 下 来 我 们 要 实现 照片 上 传 功能 。 先 检查 一 下 ,确保 你 像 8.2.1 市 讨论 的 那样 ， 在 程序 中 定义 
了 photos 配 置 项 。 这 样 你 就 可 以 在 各 种 环境 下 随意 改变 存放 照片 的 目录 了 。 现 在 我 们 要 把 照片 
放 在 ./public/photos 目 录 下 ， 像 下 面 代 码 中 设置 的 那样 。 创 建 这 个 目录 。 


代码 清单 8-12 ”可 以 设 定 照片 上 传 目 的 地 址 的 定制 配置 项 

















app.configure{(function{(}t 





aPP.Set('views', _ _ dirname + '/vVviews').: 
aDDP.Set('view engine', 'ejs'): 
app.set{('photos', dirname + '/pPublic/photos'); 


实现 照片 上 传 功能 总 共 分 三 步 : 
口 定义 照片 模型 ; 

口 创建 照片 上 传 表单 ; 

口 显示 照片 列表 。 


8.4.1 实现 照片 模型 


我 们 会 用 第 $ 草 讨论 的 Mongoose 模 型 做 照片 模型 。 用 npm install mongoose --save 安 装 
Mongoose。 人 然后 创建 文件 ./models/Photo.js， 模 型 的 定义 在 这 里 。 


代码 清单 8-13” 照 厂 模 型 








Var mongoose = require('mongoose'); 
mongoose.connect('mongodb://localhost/photo app'); ee 
建立 到 |localhost 上 mongodb 的 
var Schema = new mongoose.Schemalt 连接 ， 用 photo _app 做 数据 库 
name: String, 


path: String 
}); 


module.exports = mongoose.model ('Photo', schema); 
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Mongoose 的 模型 上 有 所 有 的 CRUD 方 法 (Photo .create、Photo.update、Photo .remove 
和 Photo .findq )， 所 以 这 样 就 搞定 了 。 


8.4.2 ”创建 照片 上 传 表 单 


照片 模型 已 经 到 位 ， 现 在 你 可 以 做 上 传 表 单 和 相关 路 由 了 。 跟 其 他 页 面 一 样 ， 你 需要 给 上 传 
页 面 定 义 一 个 GET 路 由 和 一 个 PosT 路 由 。 

你 要 把 照片 目录 传 给 PosT 处 理 需 ， 并 返回 一 个 路 由 回调 ， 以 便 处 理 融 可 以 访问 这 个 目录 。 
把 新 路 由 添加 到 app.js 中 ， 放 在 默认 (/) 路 由 下 面 : 


app.get{'/upload', photos.form).; 
app.Post('/upload', photos.submit (app.get('pPhotos')));: 








创建 照片 上 传 表 单 
接 下 来 要 创建 图 8-17 中 的 上 传 表 单 。 这 个 表单 中 包含 一 个 可 选 的 照片 名 称 和 图 片 的 文件 上 传 
人 


Phota Upload = Mozilla Firefox 
EE) | 0 Photo Upload 4 


贡 lacalhost 


Photo Upload 


Uplaad a photo to your account below 


Upload 


图 8-17 照片 上 传 表单 
用 下 面 的 EJS 代 码 创 建文 件 views/photos/upload.ejs。 
代码 清单 8-14 上传 文件 的 表单 


<1DOCTYPE html> 
<html> 
<head> 
<title><%= title %S></title> 
<link rel='stylesheet' href='/stylesheets/style.css' /> 
</head> 
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<body> 
<h1l><%= title %$></hl> 
<p>Upload a photo to your account below.</p> 
<form method='post' enctype='multipart/form-data'> 


<pP><input 
type='text', name='photolnamel]', placeholder='Name'/> 
</p> 

<p><input type='file', name='photol[limagel] '/></p> 

<p><input type='submit', value='Upload'/></p> 

</form> 
</body> 
</html> 


接 下 来 我 们 添加 照片 上 传 的 路 由 。 

为 照片 上 传 页 面 添加 路 由 

你 已 经 有 了 照片 上 传 表单 ， 但 还 没 办 法 显示 它 。photos .form 国 数 将 完成 这 个 任务 。 
在 ./routes/photos.js 中 输出 的 form 滑 数 会 演 染 ./views/photos/upload.ejs。 


代码 清单 8-15 ”添加 表单 路 由 


exports.form = function(req, res)t 
res.render('Photos/upload', 1 
title: 'Photo upload' 


}); 





}; 

处 理 照 片 提交 

接 下 来 你 需要 一 个 路 由 来 处 理 表 单 提交 。 就 像 在 第 7 章 讨 论 过 的 ，bodyParser () ， 更 具体 
地 说 是 multipart () 中间 件 (包含 在 bodyParser 中 )， 它 会 给 你 一 个 req.files 对 象 ， 代 表 上 
传 的 文件 ， 并 把 这 个 文件 保存 到 硬盘 中 。 你 可 以 通过 req .files .photo.image 访 问 这 个 对 象 。 
上 传 表单 中 的 输入 域 ， photo [name] ， 可 以 通过 reg .body .photo .name 访问 到 。 

这 个 文件 被 fs .rename () “移动 ”到 新 的 目的 地 ， 这 个 目的 地 在 传 给 sxports .supmit () 
的 'air' 中 。 记 住 ， 在 我 们 这 个 例子 中 ，diz 是 你 在 app.js 中 定义 的 配置 项 photos。 在 文件 被 挪 
到 位 后 ， 一 个 新 的 Photo 对 象 被 组 猴 出 来 ， 市 着 照 请 的 名 称 和 路 径 被 保存 下 来 。 在 成 功 保存 后 ， 
用 户 被 重 定 回 到 首页 ， 代 码 如 下 所 示 。 


代码 清单 8-16 ”添加 照片 提交 路 由 定义 











var Photo = require('../models/Photo'); < 一 引入 Photo 模 型 
var path = require('path'); 
var fs = regquire('fs'); 
var Join = path.jJoin; Se 4 半 ( 刻 二 小 
] p J 引用 path.join， 这 样 你 就 
可 以 用 “path” 命 名 变量 
exports.submit = function (dir) { 
return function(req, res, next)t Ea 
ee | , 默认 为 原来 的 
Var img = reqgq.files.photo.1image; 福 件 名 
var name req.body.photo.name || img.name; x 


Var path join(dir, img.name); 
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fs,rernamaefirmc. pathnh，Dath，Euonctcionmnfeee) < 一 重 命 名 文件 
、 加 if (err) return next (err),; 
委派 错误 加 
Photo.create l(t 


name: name, 
path: img.name 

}, function (err) { 
if (err) return next (err); < 一 委派 和 
res.redirect('/'); 


} | 重 定向 到 首页 


J 


太 棒 了 1 你 能 上 传 照片 了 。 接 下 来 你 将 要 实现 把 它们 显示 在 首页 上 的 必要 慰 辑 。 


8.4.3 显示 上 传 照片 列表 
在 8.3.3 节 ， 我 们 在 实现 路 由 app.get ('/'，photos.1list) 时 使 用 了 假 数据 。 现 在 该 真 数 


据 上 场 了 。 
之 前 那个 路 由 回调 除了 把 假 照 请 数组 传 给 模板 之 外 什么 也 没 做 ， 如 下 所 示 : 
exports.list = function(req, res}t 
res.render{({'photos', { 





title: 'Photos', 
Photos: Photos 
}); 
3 


新 版 本 用 Mongoose 提 供 的 Photo .find 获取 你 上 传 的 照片 。 不 过 你 要 注意 ， 如 果 照 片 集合 
大 ， 这 个 例子 的 性 能 会 比较 差 。 我 们 会 在 下 一 章 讲解 如 何 分 页 
一 旦 带 着 photos 数 组 的 回调 被 调用 ， 路 由 的 其 余部 分 就 和 引入 异步 查询 之 前 一 样 。 


代码 清单 8-17 ”修改 过 的 list 路 由 


ceXDortSs. 11Sst = function(regq, res, next)t 
Photo.find({}, function(err, photos)t 
if (err) return next (err); 
res.render('photos', { 
title: 'Photos', 
photos: photos 
于 
}); 
}; 本 


我 们 还 要 改 一 下 ./views/photos/index.ejs 模 板 ， 让 它 显示 ./public/photos 中 的 照片 。 


Ee 18 修改 视图 让 它 使 用 为 photos 路 径 设 定 的 配置 项 














| {} 查 出 photo 和 集合 中 的 所 有 记录 


|e 


之 多 OT EW { 名 > 
<div class="photo"> 
<h2><%=photo.name®S></h2> 
<img src='/pPhotos/<%=photo.path®>'/> 


灵 社 区 会 员 quqingtao 专 享 尊重 版 权 


8.$ 创建 资源 下 载 179 


</div> 
< 省 }】 名 > 


首页 中 现在 有 了 一 个 动态 列表 ， 显 示 这 个 程序 中 上 传 的 照 请， 如 图 8-18 所 示 。 





Photos -~ Mozilla Firefox 
项 | 好 Photos "i 


< Localhost:300 


Photos 


Express stock photo application. 


Flower 





图 8-18 ”到 目前 为 止 照片 程序 的 样子 
到 目前 为 止 我 们 定义 的 都 是 简单 路 由 : 它们 不 接受 通配符 。 接 下 来 我 们 要 深入 到 Express 的 路 
由 能 力 中 。 


8.5 创建 资源 下 载 


你 已 经 用 express .static() 提 供 了 静态 0 但 Express 提 供 Wb ee ab 
啊 应 方法 。 其 中 包括 传送 文件 的 res .sendfile(), 它 的 变 体 res .download()，, 后 者 会 在 浏览 
侣 中 提示 用 户 保 存 文件 。 

本 刷 会 对 程序 进行 调整 ,添加 一 个 GET /photo/:id/download 路 由 ， 以便 用 户 可 以 下 载 原 
来 上 传 的 照片 。 


8.5.1 创建 照片 下 载 路 由 


首先 你 要 给 照片 添加 一 个 链接 ， 这 样 用 户 才 能 下 载 它 们 。 打 开 ./views/photos/index.ejs， 按 照 
下 面 的 代码 修改 它 。 在 img 标 签 外 面 添加 一 个 指 辐 GET /Photo/: idq/dqow1Load 路 由 的 链接 。 


代码 清单 8-19 ”添加 下 载 链接 


<% photos.forEach(function(photo) { 各 > 


SU PH | Mongoose 提 供 了 ID 域 , 可 以 用 

















<h2><%=photo.name%></h2> 来 查找 特定 的 i 
查找 特定 的 记录 
<a href=' /photo/<%=photo.id%>/download'> 
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<img src='/photos/<%=photo.path®S>'/> 


</A> 
</div> 
< }) $B> 





回 到 app.js 中 ， 在 路 由 定义 中 找 个 你 喜欢 的 地 方 把 下 面 这 条 路 由 加 进去 : 
app.get{'/photo/:id/download', photos.download(app.get('photos'))).; 


尝试 这 个 功能 之 前 ， 你 还 需要 一 个 下 载 路 由 。 我 们 去 把 它 实 现 了 吧 ! 
8.5.2 ”实现 照片 下 载 路 由 


在 ./routes/photos.js 中 输出 download 函 数 ， 如 代码 清单 8-20 所 示 。 这 个 路 由 会 加 载 被 请 求 的 
文件 ， 并 传输 给 定 路 径 下 的 文件 。 Express 提 供 的 res .sendfile() 用 了 跟 express.static() 
一 样 的 代码 ， 所 以 它 也 有 HTTP 缓 存 、 范 围 请 求 等 功能 。 这 个 方法 也 接受 相同 的 选项 ， 所 以 你 也 
可 以 把 { maxAge: oneYear } 这 样 的 值 作为 第 二 个 参数 传 给 它 。 


代码 清单 8-20 照片 下 载 路 由 








exports.download = function(dir)t < 一 设 定 你 要 提供 的 文件 所 在 的 目录 
return function(req, res, next)t < 一 设 定 路 由 回调 
Var id = regq.params.1id; 
Photo.findById(id, function(err, photo)t < 一 加载 照片 记录 
if (err) return next (err); 
var Path = Join(dir,. Dhoto. vathy: < 一 构造 指向 文件 的 绝对 路 径 
res.sendfile(path).; < 一 传输 文件 


}); 
} 
}; 


如 果 你 现在 启动 程序 ， 在 通过 认证 后 你 应 该 可 以 点 击 照 片 了 。 

你 得 到 的 结果 也 许 和 你 想 的 不 一 样 。 res.sendfilel( ) 传输 数据 , 浏览 大 会 解释 数据 。 对 于 
图 乒 浏览 栗 会 在 窗 口 中 显示 它们 ， 如 图 8-19 所 示 。 接 下 来 我 们 要 看 一 下 res .download (), 它 
会 让 训 览 亏 提 示 用 户 是 否 下 载 文 件 。 

SENDFILE 回 调 参数 ”回调 函数 也 可 以 作为 第 二 个 或 第 三 个 参数 ( 当 使 用 选项 时 )， 

以 便 在 下 载 完 成 时 通知 程序 。 比 如 说 ， 你 可 以 用 回调 函数 扣 减 用 户 的 下 载 信 用 点 。 

1. 触发 浏览 器 下 载 

用 res.dqowmload() 代 蔡 res.senafile() 会 改变 浏览 厚 收 到 文件 后 的 行为 。 啊 应 头 域 
contentDispbposition 会 被 设 定 为 文件 的 名 称 ， 浏 览 需 会 相应 地 提示 用 户 下 载 。 
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downlaoad (JPEG Image, 2360 x 1702 pixols) = Scaled (220) = Mozilla Firef ox 





EE) download (JPEG Image 下 


Localhast 





图 8-19 ”用 res.sendfileO 传 输 的 照片 
从 图 8-20 中 可 以 看 到 , 图 片 的 原始 名 称 ( littlenice by dhorjpeg ) 被 用 作 了 被 下 载 文件 的 名 称 。 
这 对 你 的 程序 来 说 可 能 并 不 是 理想 的 选择 。 
接 下 来 我 们 看 一 下 res .download () 限 数 可 选 的 文件 名 参数 。 





Opening littlenice-by-dhor.jpPeg 





You have chosen to open: 
图 littlenice_by-dhor.jpeg 


which is a: JPEG image (475 KB) 
from: http://localhost:3000 


What should Firefox do with this file? 


和 Open with Image Viewer (default) 


Save File 


Do this automatically for files like this from now on. 


Cancel 


区 8-20 ”用 res .download() 传 输 的 图 片 


2. 设 定 下 载 的 文件 名 
你 可 以 用 res .download() 的 第 二 个 参数 定义 一 个 定制 的 文件 名 , 在 下 载 时 取代 默认 的 原始 
文件 名 。 代 码 清单 8-21 修 改 了 之 前 的 实现 ， 给 出 照片 被 上 传 时 提供 的 名 称 ， 比 如 Flowerjpeg。 
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代码 清单 8-21 给 出 显 式 文件 名 的 照片 下 载 路 由 


var path = join(dir, photo.path}); 
res.download(path, photo.name+' .Jpeg'}; 








如 果 你 现在 启动 程序 后 再 点 击 照 片 ， 浏 览 带 应 该 会 提示 你 是 否 下 载 它 ， 如 图 8-21 所 示 。 


Opening Flower.jpeg 
You have chosen to open: 
加 Flower.jpeg 


-Which is a:jPEG image (475 KB) 
from: http://localhost:3000 


AAA = chanild Firofnyv dn with +hic filea? 


图 8-21 用 res .download() 传 给， 并 且 文 件 名 被 定制 的 照片 


8.6 小结 





在 这 一 章 里 ， 你 学 到 了 如 何 从 头 开 始 创建 Express 程 序 ， 以 及 如 何 处 理 常 见 的 Web 开 发 任务 。 

你 学 到 了 典型 的 Express 程 序 如 何 组 织 目 录 , 如 何 使 用 环境 变量 ,以 及 如 何 用 app .configure 
方法 改变 程序 在 不 同 环境 下 的 行为 。 

Express 程 序 中 最 基本 的 组 件 是 路 由 和 视图 。 你 学 到 了 如 何 泻 染 视 图 ， 如 何 通 过 设 定 app.1locals 
和 res .locals， 以 及 和 百 接 将 值 传 给 res .render () 来 把 数据 输出 到 视图 中 。 你 还 学 到 了 基本 路 
由 的 工作 机 制 。 

在 下 一 章 里 ,我 们 将 会 学 到 如 何 用 Express 做 更 高 级 的 事情 , 比如 认证 、 路 由 、 中 间 件 和 REST 
API, 
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Express 进 阶 


本 章 内 容 

口 实现 认证 

口 URL 路 由 

口 创建 REST API 
口 处 理 错 误 





本 章 会 介绍 一 些 高 级 的 Express 技 术 ， 让 你 可 以 利用 这 个 框架 中 更 高 级 的 功能 。 

我 们 要 创建 一 个 简单 的 程序 来 前 明 这 些 技术 ,这 个 程序 允许 人 们 注册 ,提交 公开 的 消息 , 按 
发 布 时 间 逆 序 呈 现 给 访问 者 观看 。 这 种 程序 被 称 作 “ 吼 吼 箱 ”(shoutbox )。 图 9-1 是 程序 的 首页 和 
用 户 注 册页 ， 图 9-2 是 登录 和 发 布 页 。 

这 个 程序 需要 添加 如 下 逻辑 : 

口 认证 用 户 ; 

口 实现 校 验 和 分 页 ; 

口 提供 一 个 公开 表述 性 状态 转移 ( REST ) API， 以 发 送 和 接收 消息 。 


ANQ Mozilla Firefox @NMN Mozilla Firefox 


|e” http:/ /127.0.0.1:3000/ l 十 | | 份 http://127.0.0.1:3000/register [+ | 
-pgp pe 
P| @ 127.0.0.1:3( C sy coooQ HR) DB:) » 127.0.0.1:3000 C SY- coooQ MA 


login register 














Cats can't read minds Register 

Mike, | hate to tell you, buddy, but | 2 

think you're wrong about the cat thing. Fill in the form 

Cats have very complex inner lives. It's 

not all about you. below to sign up! 


Posted by rick 


| think my cat can read my mind 





Sometimes if | think something negative 

about my cat my cat will turn, Te 
suddently, to stare at me. | think my cat 
can hear my thoughts and, while it can't 
understand English, can tell my 
sentiments by the tone of my mind's 
voice. 


Posted by mike 








图 9-1 吼 吼 箱 程 序 的 首页 和 用 户 注 册页 
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aMNMNQ Mozilla Firefox 从 站 Mozilla Firefox 














用 好 http://127.0.0.1:3000/login \ 十 he http://127.0.0.1:3000/post | 十 
(4 127.0.0.1:3 = sd co0oQ MB) :| (4JAp 127.0.0.1:3 Cs GoogQ. 
Login Post 
Fill in the form Fill in the form 
below to sign in! below to add a 
new post. 











图 9-2” 吃 吃 箱 程序 的 登录 和 发 布 页 
我 们 先 从 利用 Express 做 用 户 的 号 份 认证 开始 。 


9.1 认证 用 户 


本 方 从 创建 认证 系统 开始 吃 吃 箱 程序 的 开发 工作 。 你 将 要 完成 如 下 任务 : 

口 存储 和 认证 已 注册 用 户 的 逻辑 ; 

口 注册 功能 ; 

口 登录 功能 ; 

口 为 用 户 登 录 请 求 加 载 用 户 信息 的 中 间 件 。 

为 了 用 户 认 证 ， 你 需要 把 数据 存 起 来 。 我 们 在 这 个 程序 中 用 的 是 5.3.1 太 中 介绍 过 的 Redis。 
它 安 猴 快 捷 ,， 学习 曲线 平滑 ， 对 于 只 想 重点 关注 程序 逻辑 ,不 想 为 数据 库 层 操心 的 我 们 来 说 是 非 
各 好 的 候选 方案 。 本 草 跟 数据 库 的 交互 几乎 适用 于 所 有 可 用 的 数据 库 ,， 所 以 如 有 末 你 喜欢 冒险 ,可 
以 目 行 把 Redis 换 成 你 喜欢 的 数据 库 。 我 们 先 创 建 User 模 型 。 


9.1.1 保存 和 加 载 用 户 


本 节 会 按照 一 系列 的 步骤 实现 用 户 加 载 、 保 存 和 认证 。 你 将 完成 下 面 这 些 任务 : 

口 用 package.json 定 义 程 序 的 依赖 项 ; 

口 创建 用 户 模型 ; 

口 添加 用 Redis 加 载 和 保存 用 户 的 逻辑 

口 用 becrypt 增 强 用 户 密 码 的 安全 性 ; 

口 添加 逻辑 对 用 户 的 登录 请 求 进行 认证 。 

Berypt 是 一 个 加 盐 的 哈 希 函数 ， 是 专门 用 来 对 密码 做 哈 希 处 理 的 第 三 方 模块 。Berypt 特 别 适 
合 处 理 密码 ， 因 为 计算 机 越 来 越 快 ， 而 bcrypt 能 让 破解 变 慢 ， 从 而 有 效 对 抗暴 力 攻 击 。 
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1. 创建 PACKAGE.JSON 文 件 

为 了 创建 一 个 支持 EJS 和 会 话 的 程序 骨架 , 打开 命令 行 窗 口 , 进入 你 的 开发 目录 ,输入 express 
-e -s shoutbox。 虽 们 在 前 面 用 过 标记 -e， 在 app.js 中 局 用 对 EJS 的 文 持 。 而 标记 -s 局 用 对 会 话 

程序 骨架 创建 好 后 ， 进 入 shoutbox 目 录 。 接 下 来 修改 指明 依赖 项 的 package.json 文 件 ,在 其 中 
再 添加 两 个 模块 。 修 改 后 的 package.json 文 件 看 起 来 应 该 如 下 所 示 : 
代码 清单 9-1 额外 增加 了 依赖 项 bcrypt 和 Redis 的 package.json 文 件 

{ 











"name": "shoutbox", 

"version":; "0O.0.1", 

"Private"”: true, 

"scripts": { 
"start": "node app' 

上 3 

"dependencies": { 
"express": "3.x", 
"EJS Mw, 
BeryBt es: MOTT.3", 
"redis": "OO.7.2" 


} 
} 


输入 npm install 安 装 依 赖 项 。 这 会 把 它们 装 到 ./node _modules 目 录 下 。 

最 后 输入 下 面 的 命令 创建 一 个 空白 的 EJS 模 板 文件 ， 以 便 稍 后 定义 。 因 为 这 个 模板 会 被 其 他 
模板 文件 引入 ， 所 以 如 果 不 先 创 建 它 ， 程 序 会 报错 : 

touch views/menu,.eis 

设置 好 程序 骨架 ， 痰 好 依赖 项 ， 现 在 你 可 以 定义 用 户 模型 了 。 

2. 创建 用 亡 模 型 

你 现在 需要 创建 一 个 lib 目 录 , 并 在 其 中 创建 一 个 名 为 user .js 的 文件 。 把 用 户 模型 的 代码 放 
在 这 个 文件 中 。 

代码 清单 9-2 是 首先 要 添加 的 逻辑 。 这 段 代码 引入 了 依赖 项 redis 和 bcrypt，, 然后 用 redis. 
createClient () 打 开 Redis 连 接 。 国 数 Uuser 可 以 接受 一 个 对 象 , 并 把 这 个 对 象 的 属性 合并 进去 。 
比如 说 ，new User({ name: 'Tobi' )) 会 创建 一 个 对 象 ， 并 将 对 象 的 属性 name 设 定 为 Tobi。 


代码 清单 9-2 ”开始 创建 用 户 模型 














var redis = regquire('redis'); 
Var bcrypt = require('bcrypt'); 创建 到 Redis 的 长 连接 
var db = redis.createClient(),; 从 这 个 模块 中 输出 
nodule. exports = User: ,| User 函 数 
touncebion User(ob]) + 遍历 传 入 对 象 中 的 键 
for (var key in obj) { | 
this[key] = obj[keyl]; < 一 合并 值 


) 
} 
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3. 把 用 户 保 存 到 Redis 中 

你 需要 的 下 一 个 功能 是 保存 用 户 ， 把 用 户 的 数据 保存 到 Redis 中 。 代 码 清单 9-3 中 的 save () 
方法 检查 用 户 是 否 有 ID ， 如 果 有 就 调用 update () 方 法 ， 用 名 称 索 引用 户 ID ， 并 用 对 象 的 属性 组 
疙 出 Redis 哈 希 表 中 的 记录 。 如 果 用 户 没 有 ID， 则 认为 这 是 一 个 新 用 户 ， 增 加 user:ids 的 值 ， 给 
用 户 一 个 唯一 的 了, 然后 在 用 相同 的 update () 方 法 把 用 户 保存 到 Redis 中 之 前 对 密码 做 哈 硕 处 理 。 

把 下 面 的 代码 加 到 1libmuserjs 中 。 


代码 清单 9-3 用户 模型 中 的 save 实 现 
User.prototype.save = function (fn)t 
1 Ed < 一 用 户 已 存在 
this.update (fn); 
} else { 
Var user = this; 
db.incr('user:ids', function(err, id)t < 一 创建 唯一 ID 
if (err) return fnl(err).; 
SG ,ia = 1id; < 一 设 定 ID， 以 便 保存 
EE user.hashPassword (function (err)t 
4 if (err) return fnl(err); 
user.update (fn); < 一 保存 用 户 属性 














User.prototype.update = function (fn})t{ 
var User = thisgs,; 
Var id = user.id; 
db.set('user:id:' + user.name, id， function(err) { <- 用 名 称 索 引用 户 ID 
if (err) return fnl(err); 
db.hmset('user:' + id, user, function(err) { 


fn (err).; | 用 Redis 哈 希 存 储 数据 


}); 
}); 
J 


4. 增强 用 户 密 码 的 安全 性 
在 用 户 刚 创 建 时 ， 需 要 有 个 .pass 属 性 用 来 设 定 用 户 的 密码 。 用 户 保存 逻辑 会 对 密码 做 哈 希 
处 理 ， 符 换 拯 .pass 属 性 。 
这 个 哈 希 处 理会 加 盐 。 每 个 用 户 加 的 盐 不 一 样 ， 可 以 有 效 对 抗 彩 虹 表 攻击 : 对 于 哈 希 机 制 而 
言 ， 盐 就 像 私 钥 一 样 。bcrypt 可 以 用 gensalt () 为 哈 希 生成 12 个 字符 的 盐 。 


彩虹 表 攻 击 “” 彩虹 表 攻 击 用 预先 计算 好 的 表 破 解 经 过 哈 布 计算 的 密码 。 维 基 百 科 
上 有 更 详细 的 介绍 : http:/en.wikipedia.org/wikiRainbow table。 
盐 生 成 了 之 后 ,调用 bcrvypt .hash()， 它 会 对 .pass 属 性 和 盐 做 哈 希 处 理 。 这 个 最 终 的 哈 希 值 
会 在 .update() 把 .pass 存 到 Redis 之 前 答 换 它 ， 确 保 不 会 保存 密码 的 明文 ， 只 保存 它 的 哈 希 结果。 
把 下 面 的 代码 加 到 lib/userjs 中 ， 其 中 定义 的 函数 会 创建 加 盐 的 哈 希 ,并 把 结果 存在 用 户 的 属 
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性 .pass 中 。 
代码 清单 9-4 在 用 户 模 型 中 添加 bcrypt 加 窗 
User.prototype.hashPassword = function (fn)t 
Var user = this; _ 生成 有 12 个 字符 的 盐 
bcrypt.genSalt(12, function(err, salt)t 


1if (err) return fnl(err).; 
user.salt = salt; 


i bcrypt.hash(user.pass, salt, function(err, hash)t ”| 设 定 盐 以 便 保存 
生成 | if (err) return fnl(err).; 
由布 user.pass = hash; 

fn () ; | 设 定 哈 希 以 便 保存 
上 上 
}); 
过 
全 做 好 了 。 


5. 测试 用 户 保 存 远 辑 
我 们 来 试 一 下 , 在 命令 行 中 输入 redis-server 启 动 Redis 服 务 右 。 在 lib/userj s 最 后 加 上 代码 
清单 9-5 中 的 代码 ， 它 会 创建 一 个 示例 用 户 o 然后 在 命令 行 中 运行 hode 1ib/user 创 建 用 户 o 


代码 清单 9-5 ”测试 用 户 模 型 








var tobi = new User(t < 一 创建 用 户 
name: 'Tobi', 
Pass: 'im a ferret', 
age: '2' 

}); 

tobi.save(function (err)t < 一 保存 用 户 
if (err) throw err; 
console.log('user id %d', tobi.id); 


}); 
现在 应 该 能 看 到 表明 用 户 创 建成 功 的 输出 ,比如 : user iq 1。 测试 完 用 户 模型 ， 从 lib/user.js 
中 去 挥 代码 清单 9-5 中 的 代码 。 

在 使 用 Redis 中 的 工具 redis-cli 时 ， 可 以 用 HecETaALIL 命 令 取出 哈 希 表 中 的 所 有 键 值 对 ， 像 下 面 
这 个 命令 行 会 话 中 所 演示 的 这 样 : 


代码 清单 9-6 使 用 redis-cli 工 具 查 看 存储 数据 





s redigs=Cl11 < 一 启动 Redis 命 令 行 
redis> get user:ids 
是 | 雪 册 最 过 凶 是 
3 的 ID 
0 user:1 取出 哈 希 表 条 目 用 户 的 
哈 希 表 条 目的 2) "Tobi" 中 的 数据 
属性 3) "pass'" 
4) "SS2a5125SBAOWTHhTAKN]JY7UPLOUGBKuU46eDGPKPK51IJcftoOeLWO8SMCcfEEL7 .EN." 
5) "age'" 
6) "2 
7 a 
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8 ) nn 4 nn 
9) "salt" 
10) "$2a$12SBAOWThNTAKNJY7UhtOUdBku" 退出 Redis 命 令 行 
redis> gquit 








用 户 保 存 的 逻辑 定义 好 了 ， 该 添加 获取 用 户 信息 的 逻辑 了 。 
其 他 可 以 在 REDIS-CLI 中 运行 的 命令 要 了 解 与 Redis 命 令 有 关 的 更 多 内 容 ， 请 参 

见 Redis 命 令 参 考 手 册 : http://redis.io/commands。 

6. 获取 用 户 数 据 

在 用 户 想 要 登录 一 个 Web 程 序 时 ,通常 会 在 表单 中 输入 用 户 名 和 密码 ， 然 后 把 这 些 数据 提交 
给 程序 进行 认证 。 在 登录 表单 被 提交 后 ， 你 需要 一 个 能 通过 用 户 名 获取 用 户 的 方法 。 

这 个 逻辑 在 下 面 的 代码 清单 中 被 定义 为 User .getByName ()。 这 个 函数 先 用 User .getId() 
查找 用 户 ID, 然后 把 ID 传 给 User .get () ,由 它 负 责 取 得 Redis 哈 希 表 中 的 用 户 数据 。 将 下 面 的 逻 
辑 加 到 1lib/userjs 中 。 


代码 清单 9-7 ”从 Redis 中 取得 用 户 
User.getByName = function(name, fn)t 加 根据 名 称 查 找 用 户 ID 


User.getIid(name, function(err, id)t 
if (err) return fnl(err); 




















Ber .det (1 fn) < 一 用 ID 抓 取 用 户 

}); 

j 

User.getId = function(name, fn)t{ 取得 由 名 称 索引 的 ID 
db.get('user:id:' + name, fn); 

}; 

User.get = function(id, fn)t 获取 普通 对 象 哈 希 
db.hgetall('user:' + id, function(err, user)t 


1if (err) return fnl(err); 
fn(null, new User (user)); 
J 
}; 


现在 已 经 得 到 了 经 过 哈 希 的 密码 ， 可 以 继续 处 理 用 户 的 认证 了 。 

7. 认 证 用 尸 登录 

用 户 认 证 所 需 的 最 后 一 个 方法 在 下 面 的 代码 清单 中 ， 它 用 到 了 前 面 定义 的 用 户 数 据 获取 也 
数 。 把 这 个 添加 到 1ib/user .js 中 。 


代码 清单 9-8 ”认证 用 户 的 名 称 和 密码 


| 将 普通 对 象 转换 成 新 的 User 对 旬 











User.authenticate = function(name, pass, fn)t 
User.getByName (name, function(err, user)t < 一 通过 名 称 查找 用 户 
If (err) return fn (err).; 
jf (IiIuser.id) return fn().; < 一 用 户 不 存在 
从 bcrypt.hash(pass, user.salt, function(err, hash)t 

对 给 出 的 
密码 做 哈 1f (err) return fnl(err).; 
希 处 理 1 (hash == USer,. Bass}) return fn(null, User}; < 一 匹配 发 现 项 
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fn(); < 一 密码 无 效 


}; 
认证 逻辑 从 用 名 称 获 取 用 户 开 始 。 如 采 没 找到 用 户 ， 马 上 调用 回调 函数 。 和 否则 把 保存 在 用 户 
对 象 中 的 盐 和 提交 上 来 的 密码 进行 哈 硕 ,产生 的 绪 采 应 该 跟 保 存在 user.pass 中 的 哈 布 信 相同 。 
如 果 提 交 上 来 的 和 保存 的 哈 硕 值 不 匹配 , 则 表明 用 户 输入 的 凭证 是 无 效 的 。 当 碍 找 不 存在 的 键 时 ， 
Redis 会 给 你 一 个 空 的 哈 硕 值 所 以 这 里 所 用 的 检查 是 Iuser.1d, 而 不 是 IUSeTLo 
现在 你 能 认证 用 户 了 ， 还 需要 提供 一 种 办 法 让 用 户 注册 。 


9.1.2 ”注册 新 用 户 


为 了 让 用 户 创建 新 账号 然后 登录 ， 你 需要 注册 和 登录 功能 。 
本 节 需 要 完成 下 面 的 任务 实现 注册 : 

口 将 注册 和 登录 路 由 映射 到 URL 路 人 径 上 ; 

口 添加 显示 注册 表单 的 注册 路 由 逻辑 ; 

口 添加 逻辑 存储 从 表单 提交 上 来 的 用 户 数据 。 

表单 如 图 9-3 所 示 。 

















Register 


Fill in the form below to sign up! 


Sign Up 


图 9-3 ”用 户 注册 表单 





当 用 户 用 浏览 絮 访 问 /register 时 会 显示 这 个 表单 。 稍 后 你 会 创建 一 个 类 似 的 表单 让 用 户 登 录 。 

1. 添加 注册 路 由 

要 显示 注册 表单 , 首先 要 创建 一 个 路 由 泻 染 这 个 表单 ,并 把 它 返 回 给 用 户 的 浏览 硕 显 示 出 来 。 

参照 代码 清单 9-9 修 改 app.js， 这 段 代 码 用 Node 的 模块 系统 从 routes 目 录 中 引入 定义 注册 路 由 
行为 的 模块 , 并 把 HITP 方 法 及 URL 路 径 关 联 到 路 由 函数 上 。 构成 一 个 “前 痪 控 制 希 "。 如 你 所 见 ， 
这 里 既 有 GET 注 册 路 由 ， 也 有 POST 注册 路 由 。 
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入 EA 诡 加 注册 路 由 


Var register = require('./routes/register'); < 引入 路 由 逻辑 
app.get('/register', register.form).; < 一 添加 路 由 
app.post('/register', register.submit).; 


接 下 来 定义 路 由 逻辑 ， 在 routes 目 录 下 创建 一 个 空白 文件 ， 命 名 为 registerjs。 注 册 路 由 行为 
的 定义 从 输出 routes/register.js 中 的 下 面 这 个 函数 开始 一 一 一 个 泻 染 registration 模 板 的 路 由 : 


exports.form = functionl(req, res}t 
res.render('register', { title: 'Register' }); 


}; 

这 个 路 由 用 了 -个 般 入 式 JavaScript ( EJS ) 模板 ， 你 接 下 来 就 要 创建 它 ， 定 义 注 册 表 单 的 
HITML., 

2. 创建 注册 表单 

为 了 定义 注册 表单 的 HTML， 需 要 在 views 目 录 中 创建 一 个 名 为 register.ejs 的 文件 。 你 可 以 用 
下 面 这 个 代码 清单 中 的 HTML/EJS 定 义 它 。 


代码 清单 9-10 ”提供 注册 表单 的 视图 模板 
<IDOCTYPE html> 
<htmi|l> 
<head> 
<title><%®= title ®%></title> 
<link rel='stylesheet' href='/stylesheets/style.css' /> 














</head> 
<body> 区 后 面 要 添 加 的 导航 
<% include menu %> 链接 
<h1l><%= title %$></h1> 
<p>Fill in the form below to sign up!</p> 显示 稍 后 添加 
< 名 include messages %> 的 消息 
<form action='/register' method='post'> 
<p> 
<input type='text' name='user[lname]' placeholder='Username' /> 
用 户 必须 输 | Sn 
入 用 户 名 “D> 
<ijnput type='password' name='userl[lpass]' 
placeholder='Password' /> 用 户 必 须 输 
0 入 密码 
<p> 
<input type='submit' value='Sign Up' /> 
< /了 好 > 
</ftorm> 
</body> 
</html> 





注意 上 面 代码 中 的 ijnclude messages， 它 包含 了 夯 外 一 个 模板 : messages .ejs。 你 接 下 
来 会 i 文 个 模板 ， 它 是 用 来 跟 用 户 沟通 的 。 
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3. 把 反馈 传达 给 用 户 

在 用 户 注册 过 程 中 ,以 及 在 一 个 典型 程序 的 大 多 数 场景 中 , 都 有 必要 将 反馈 传达 给 用 户 。 比 
如 说 ,用 户 可 能 会 用 一 个 已 经 被 其 他 人 占用 的 用 户 名 注册 。 在 这 种 时 候 ， 你 需要 让 用 户 再 选 一 个 
用 户 名 。 

在 你 的 程序 中 ，messages.ejs 模 板 就 是 用 来 显示 错误 的 。 程 序 中 的 很 多 模板 都 会 包含 
messages.ejs 模 板 。 

在 view 目 录 下 创建 一 个 名 为 messages.ejs 的 文件 , 把 下 面 的 代码 片段 放 到 这 个 文件 里 面 。 这 个 
檬 板 中 的 代码 检查 变量 locals .messages 是 否 有 设 定 ， 如 果 有 ， 模 板 会 循环 遍历 这 个 变量 显示 
消息 对 象 。 每 个 消息 对 象 都 有 一 个 type 属 性 〈 如 有 果 需 要 ， 你 可 以 用 消息 做 非 错 误 通 知 ) 和 一 个 
stzing 属 性 (消息 文本 )。 程序 可 以 把 要 显示 的 错误 添加 到 res .locals .messages 效 组 中 形成 
队列 。 消 息 显 示 之 后 ， 调 用 removeMessages 清 空 消息 队列 : 


<%S If (locals.messages) { 多 > 
<% messages.forEachlftunctionimessage) { %> 
<p Class='<%®= message.type %>'><%= message.string %S></p> 
< 宫 }) 第 > 








< 各 remOoveMessages () 省 > 
< 省 针 > 


图 9-4 是 显示 错误 消息 的 注册 表单 。 





Register 
Fill in the form below to Sign up! 


Username already taken! 








sign Up 


图 9-4 ”注册 表单 错误 报告 


问 res .locals .messages 中 添加 消 奶 是 一 种 简单 的 跟 用 户 沟通 的 方式 ,但 因为 res .1locals 
在 重 定 向 后 会 丢失 ， 所 以 如 果 你 要 路 越 请 求 传递 消息 的 话 ， 需 要 使 用 会 话 。 

4. 在 会 话 中 存放 临时 的 消息 

Post/Redirect/Get ( PRG ) 模式 是 一 个 常用 的 Web 程 序 设计 模式 。 在 这 种 模式 中 ， 用 户 请 求 表 
单 ， 用 HTTP POST 请 求 提 交 表 单数 据 ， 然后 用 户 被 重 定 癌 到 为 外 一 个 Web 页 面 上 。 用 户 被 重 定 问 
到 哪里 取决 于 表单 数据 是 否 有 效 。 如 果 表 单数 据 无 效 , 程序 会 让 用 户 回 到 表单 页 面 。 如 果 表 单数 
据 有 效 ， 程序 会 让 用 户 到 新 的 页 面 中 。PRG 模 式 主要 是 为 了 防止 表单 的 重复 提交 。 

在 Express 中 ， 用 户 被 重 定 问 后 ，res .locals 中 的 内 容 会 被 重 置 。 如 果 你 把 发 给 用 户 的 消息 
存在 res .1locals 中 ， 这些 消息 在 显示 之 前 就 已 经 丢失 了 。 然 而 如 果 把 消息 存在 会 话 变 量 中 ， 就 
可 以 解决 这 个 问题 。 消 息 可 以 在 重 定 回 后 的 最 终 页 面 上 显示 。 
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为 了 能 在 会 话 变量 中 形成 消息 队列 ， 需 要 在 程序 中 添加 一 个 模块 。 创 建 一 个 名 为 .Jib/ 
messages.js 的 文件 ， 加 入 下 面 这 些 代码 : 


Var express = require('express'); 
VAar res = express.response; 





res.message = function (msg, type)}l 
type s typBe || "nfeors 
var sess = this.reg.session,; 
sess.messages = sess.messages || []:; 
sess.messages .push({ type: type, string: msg }}); 


}; 

res.message 国 数 可 以 把 消息 添加 到 来 目 任 何 Express 请 求 的 会 话 变 量 中 。express .response 
对 象 是 Express 给 啊 应 对 象 用 的 原型 。 回 这 个 对 象 中 汰 加 属性 意味 看 所 有 中 间 件 和 路 由 都 能 访问 它 
们 。 在 前 面 的 代码 片段 中 ，express .response 被 赋 给 了 一 个 名 为 res 的 变量 ,这样 回 这 个 对 和 象 
中 次 加 属性 更 容 兄 ， 还 提高 了 可 该 性 。 

为 了 让 添加 消 恩 变 得 更 容易 ， 再 加 上 下 面 这 段 代 人 码 。 用 res .error 可 以 轻松 地 将 类 型 为 
error 的 消息 添加 到 消息 队列 中 。 它 用 到 了 在 前 面 那个 模块 中 定义 的 res .message 子 数 : 


res.error = functiontmsg)t 














return this.message (msg, ‘error').，: 


J 
最 后 是 把 这 些 消息 输出 到 模板 中 以 便 显示 。 如 果 你 不 这 样 做 ,就 必须 在 每 个 res .render () 
调用 中 传人 入 req.session.messages， 这 很 不 理想 。 

为 了 解决 这 个 问题 ， 你 将 要 创建 一 个 中 间 件 ， 在 每 个 请 求 上 用 res .session.messages 上 
的 内 容 组 法 出 res .locals .messages， 把 消 县 融 效 地 输出 到 所 有 要 渲染 的 模板 上 。 到 目前 为 
目 ，./lib/messages.js 扩 展 了 啊 应 的 原型 ， 但 它 还 没有 输出 任何 东西 。 把 下 面 的 代码 加 到 这 个 文件 
中 ， 输 出 你 需要 的 中 间 件 : 


module.exports = functionlregq, res, next)t 











res.locals.messages = regq.session.messages || []; 

res.locals.removeMessages = function()}t 
regq.Ssession.messages = [|]; 

J 

next{}); 


J 
首先 定义 一 个 模板 变量 messages 存 放 会 话 中 的 消息 ， 它 是 一 个 数组 ， 在 前 一 个 消息 中 可 能 
存在 ， 也 可 能 不 存在 〈 记 住 这 些 是 存在 于 会 话 中 的 消息 )。 接 下 来 ， 你 需要 一 个 把 消息 从 会 话 中 
移 除 的 办 法 ; 否则 它们 会 越 积 越 多 ， 因 为 没 人 清理 它们 。 

现在 ， 你 只 需 在 app.js 中 require () 这 个 文件 就 可 以 集成 这 个 功能 。 你 应 该 把 这 个 中 间 件 放 
在 中 间 件 session 下 面 ， 因 为 它 依 赖 于 req.session。 注 意 ， 因 为 这 个 中 间 件 既 不 接受 选项 ， 
也 不 返回 第 二 个 了 清 数 ， 所 以 你 可 以 调用 app .use (messages) ， 而 无 需 调 用 app .use (messages () ) 。 
为 了 适应 将 来 的 发 展 , 第 三 方 中 间 件 通 常 最 好 用 app .use (messages () ) , 而 不 管 它 是 否 接 受 选 项 : 


var register 
var messages 


























require('./routes/register').: 
require(',/lib/messages'): 
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app.use (express.methodOverride!()):; 

app.use (express.cookieParser('your secret here')}:;: 
( 
( 





app.use (express.session())}),; 


app.use (messages),， 


现在 你 可 以 在 任何 视图 中 访问 messages 和 removeMessages()， 所 以 , 不 管 出 现在 哪个 模 
板 中 ，messages.ejs 应 该 都 可 以 完美 地 完成 它 的 任务 。 

注册 表单 的 显示 完成 了 ， 也 做 出 了 向 用 户 传 达 必 要 反馈 的 办 法 ,我 们 继续 前 进 ， 去 人 处理 表单 
的 提交 吧 。 

5. 实现 用 户 注 册 

注册 表单 定义 好 了 , 你 也 给 出 了 回 用 户 传达 反 蚀 的 办 法 ,现在 你 需要 创建 一 个 路 巾 晒 数 ， 处 
理 提 交 到 /register 上 的 HTTP POST 请 求 。 这 个 晒 数 是 submit。 

就 像 我 们 在 第 7 草 讨 论 过 的 ， 当 表单 数据 提交 上 来 时 ， 中 间 件 bodyParser () 会 用 提交 的 数 
据 组 北 reg .body。 注 册 表 单 使 用 了 对 象 表 示 法 user [name] ， 经 过 Connect 的 解析 后 ， 它 会 被 翻 
译 成 req .body.user.name,。 同样 ， Iegd.body.user. pass 用 于 密码 输入 域 。 

在 submission 路 由 中 ， 你 仅 需 少量 代码 来 处 理 校 验 ， 比 如 确保 用 户 名 未 被 占用 ， 以 及 保存 
新 用 户 ， 如 代码 清单 9-11 所 示 。 


代码 清单 9-11 用 提交 的 数据 创建 用 户 


Var User = require('../lib/user'); 


Var data = reqgq.body.user; 


exports.submit = function(req, res, next)t | 检查 用 户 名 是 否 唯一 


User.getByName (data.name, function(err, user)t 





0 顺延 传递 数据 库 连接 错误 和 
7 Fedis will efaia it 其 他 错误 
if (user.1d) { 
res.error("Username already taken!").,， 用 户 名 已 经 被 占用 
res.redirect('back').; 
} else { 
user = new User(t 
name: data.name, 
pass: data.pass 


}); 


| 用 POST 数据 创建 用 户 


user.save (function (err)t < 一 保存 新 用 户 
if (err) return next (err); 为 认证 保存 uid 
req.session.uid = user.id; 
res.redirect('/'); 

a | 重 定向 到 记录 的 列表 页 
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注册 一 完成 ,user .id 就 会 被 赋 给 用 户 的 会 话 ， 你 稍 后 还 会 检查 它 ， 以 验证 用 户 是 否 通过 了 
认证 。 如 果 校 验 失 败 ， 消 息 会 作为 messages 变 量 输出 到 模板 中 ,通过 res.1locals.messages， 
并 且 用 户 会 被 送 回 到 注册 表单 中 去 。 

为 了 实现 这 一 功能 ， 请 把 代码 清单 9-11 所 示 的 代码 添加 到 routes/register.js 中 。 

现在 你 可 以 启动 程序 ， 访 问 /register， 注 册 一 个 用 户 。 接 下 来 你 还 需要 提供 一 种 办 法 ， 通 过 
/login 表 单 对 已 注册 的 用 户 进行 认证 。 





9.1.3 已 注册 用 户 登 录 


添加 登录 功能 比 注册 更 从 单 ， 因 为 大 部 分 必需 的 逻辑 已 经 在 User .authenticate() 中 了 ， 
之 前 已 经 定义 了 通用 的 认证 方法 。 

本 市 将 添加 : 

口 显示 登录 表单 的 路 由 逻辑 ; 

口 认证 从 表单 提交 的 用 户 数据 的 逻辑 。 

这 个 表单 看 起 来 应 该 如 图 9-$ 所 示 。 

















Login 


Fill in the form below to sign in! 








Login 


图 9-5 ”用 户 登 录 表单 
我 们 先 从 修改 app.jS 和 人 手 ， 引 入 登录 路 由 并 确立 路 由 路 径 : 








var login = require('./routes/login')}); 


app.get('/login', login.form).; 
app.post!('/login', login.submit).; 
app.get('/logout’', login.logout); 


接 下 来 添加 显示 登录 表单 的 功能 。 

1. 显示 登录 表单 

实现 登录 表单 的 第 一 步 是 为 与 登录 和 退出 相关 的 路 由 创建 一 个 文件 : routes/login.js。 显 示 合 
录 表 单 的 路 由 逻辑 几乎 跟 之 前 实现 那个 显示 注册 表单 的 逻辑 一 模 一 样 , 唯一 的 区 别 是 要 显示 的 模 
板 名 称 和 页 面 标题 : 


exports.form = function{(redq, res)}t 
res.render('l]ogin', { title: 'Login' }); 


}; 
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EJS 登 录 表单 会 在 ./views/login.ejs 中 定义 ， 如 代码 清单 9-12 所 示 ， 它 跟 register.ejs 也 是 极其 相 
似 ; 唯一 区 别 是 指导 说 明和 数据 要 提交 的 目标 路 由 。 


代码 清单 9-12 ”登录 表单 的 视图 模板 
<!lIDOCTYPE html> 
<html> 
<head> 
<title><%®= title %S></title> 
<link rel='stylesheet' href='/stylesheets/style.css' /> 
</head> 
<body> 
< 和 linclude menu %> 
<h1l><%= title %></hi1i> 
<D>E111 in the form below to sign in!</p> 








<% include messages 名 > 用 尸 必须 输入 
用 户 名 
<form action='/1login' method='post'> 
<p> 
<input type='text' name='user[lnamel]' placeholder='Username' /> 
</p> 
<p> 


<input type='password' name='userl[lpass]' 
placeholder='Password' /> 

</p> 

<p> 
<ijnput type='submit' value='Login' /> 

</pP> 

</ form> 
</body> 
</html> 


讨 加 了 显示 登录 表单 所 需 的 路 由 和 模板 ， 接 下 来 要 诬 加 处 理 登 录 请 求 的 逻辑 。 

2. 登录 认证 

处 理 登 录 请 求 需要 次 加 路 由 逻辑 ,对 用 户 提 交 的 用 户 名 和 密码 进行 检查 ， 如 末 正 确 ,， 将 用 户 
ID 设 为 会 话 变 量 ， 并 把 用 户 重 定 回 到 首页 上 。 把 下 面 代 码 清 单 中 的 这 个 逻辑 添加 到 routes/login.js 
文件 中 。 


代码 清单 9-13 ”处 理 登 录 的 路 由 


var User = require('../l1ib/user'),; 


| 用 户 必须 输入 密码 

















exports.submit = function(lregq, res, next)t{ 
i Var data = regq.body.user; 检查 任 
传递 错误 ， 
User.authenticate(data.name, data.pass, function(err, user) 
jf (err) return next (err):; 


if (user) { 处 理 赁 证 有 
req.session.uid = user.1d; a | . 
| 为 认证 存储 uid 效 的 用 户 


十 


res.redirect('/'):; 


重 定 同 到 记 a ， 


录 列 表 页 
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咱 
res.error("Sorry! invalid credentials."); 
， res.redirect('back').; 重 定 向 回 登 录 
了 让 表 音 
}; 
在 代码 清单 9-13 中 ， 如 果 用 户 通 过 User.authenticate() 认 证 ，reg.session.uid 会 
像 在 POSTegister 路 由 中 一 样 地 赋值 : 这 个 值 会 保存 在 会 话 中 ， 后 续 还 可 以 用 它 获 取 User 或 其 他 
与 用 户 相 关 的 数据 。 如 有 果 未 找到 匹配 的 记录 ， 会 设 定 一 个 错误 ， 并 重新 显示 登录 表单 。 
用 户 可 能 还 想 主 动 退出 系统 ， 所 以 你 应 该 在 程序 中 提供 一 个 退出 链接 。 你 在 app.js 中 赋予 了 
app.get('/logout', login.logout), 所 以 在 . /routes/l1ogin.] s 中 添加 下 面 这 个 函数 ， 
它 会 移 除 会 话 ，session() 中 间 件 检测 到 ， 会 为 后 续 请 求 赋予 新 的 会 话 : 


exports.logout = function{redgq, res)t 


输出 错误 消息 

















redq.session.destroy (function(err) { 
if (err) throw err; 





res.redirect('/'). 
}) 
} 网 


注册 和 登录 表单 都 创建 好 了 , 接 下 来 你 需要 添加 的 是 一 个 菜单 ,让 用 户 可 以 进入 这 两 个 页 面 。 
我 们 现在 就 去 创建 一 个 吧 。 

3. 为 已 认证 的 和 匿名 的 用 户 创建 菜单 

本 市 将 会 为 匿名 和 已 认证 的 用 户 创建 一 个 羔 单 ， 让 他 们 可 以 登录 、 注 册 、 提 交 消 息 , 以 及 退 
出 。 图 9-6 是 给 匿名 用 户 的 菜单 。 




















AAMAA Mozilla Firefox | 
中 http://127.0.0.1:3000/ | 
(4 127.0.0.1:3000 C 2 Google Q) [RB 


图 9-6 ”用户 登 录 和 注册 沫 单 ， 用 来 访问 你 创建 的 表单 


用 户 通过 认证 后 , 你 要 显示 万 外 一 个 沫 单 , 给 出 他 们 的 用 户 名 , 以 及 回 吼 吼 箱 发 消息 的 链接 ， 
用 户 退 出 的 链接 。 这 个 沫 单 如 图 9-7 所 示 。 





AMAQ Mozilla Firefox 





je http://127.0.0.1:3000/ | 
(© 127.0.0.1:3000 C 导 清 "Google Q | 会 | 四 -| 
EREEEEEEE 


post logout | 
| 
图 9-7 用 户 通 过 认证 后 的 菜单 


你 创建 的 所 有 表示 程序 页 面 的 EJS 模 板 , 在 标签 <bpody> 之 后 都 有 这 样 一 段 代码 : <% ijnclude 
menu %>。 这 是 要 包含 ./vViews/menu.ejs 模板 ， 你 马上 就 要 创建 它 ， 并 把 下 面 的 代码 放 进 去 。 
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代码 清单 9-14 ”匿名 和 已 认证 用 户 的 菜单 
<% If (locals.user) { 各 > 
<diw LOA= men' < 一 给 已 登录 用 户 的 菜单 
<span class='name'><%= user.name %></span> 


<a href='/post'>post</a> 
<a href='/logout'>logout</a> 


</div> 
<% } else { 各 > 
<div id='menu'> < 一 给 匿名 用 户 的 菜单 


<a href='/login'>login</a> 
<a href='/register'>register</a> 
</div> 
< } > 


在 这 个 程序 中 ,你 可 以 假定 如 果 有 user 变 量 输出 到 了 模板 中 ,那么 这 个 用 户 就 已 经 通过 认 
证 了 ,否则 你 不 会 输出 这 个 变量 ; 接 下 来 你 就 会 看 到 。 那 束 是 说 当 这 个 变量 出 现时 ， 你 可 以 显示 
用 户 名 、 消 息 握 交 和 退出 链接 。 当 访问 者 是 匿名 用 户 时 ， 显 示 网 站 登录 和 注册 链接 。 

你 可 能 在 想 这 个 本 地 变量 user 是 从 哪 来 的 一 一 你 还 没 写 它 呢 。 接 下 来 你 会 写 一 些 代码 为 每 
个 请 求 加 载 已 登录 用 户 的 数据 ， 并 证 和 模板 可 以 得 到 这 些 数据 。 


9.1.4 用 户 加 载 中 间 件 


在 做 Web 程 序 时 ， 从 数据 库 中 加 载 用 户 信 息 是 个 常见 的 任务 ， 通 常会 表示 为 一 个 JavaScript 
对 象 。 保持 这 项 数据 的 持续 可 访问 性 使 得 跟 用 户 的 交互 更 简单 。 在 这 一 草 的 这 个 程序 里 , 你 将 用 
中 间 件 为 每 个 请 求 加 载 用 户 数据 。 

中 间 件 脚本 会 放 在 ./lib/middleware/user.js 中 ， 它 会 从 上 层 目 录 ( .lib ) 中 引入 User 模 型 。 中 
间 件 函数 先 被 输出 ,然后 检查 会 话 查 看 用 户 ID。 当 用 户 ID 出 现时 ,表明 用 户 已 经 通过 认证 了 ,所 
以 从 Redis 中 取出 用 户 数 据 是 安全 的 。 

Node 是 单线 程 的 ， 没 有 线程 本 地 存储 。 对 于 HTTP 服 务 器 而 言 ， 请 求 和 响应 变量 是 唯一 的 上 
下 文 对 象 。 构 建 在 Node 之 上 的 高 层 框架 可 能 会 提供 额外 的 对 象 存 放 已 认证 用 户 之 类 的 数据 ， 但 
Express 坚 持 使 用 Node 提 供 的 原始 对 象 。 因 此 ， 上 下 文 数 据 一 般 保存 在 请 求 对 象 上 ， 比 如 在 代码 
清单 9-15 中 ， 用 户 被 存 为 req.user; 后 续 的 中 间 件 和 路 由 可 以 用 这 个 属性 访问 它 。 


代码 清单 9-15 ”加载 已 登录 用 户 数据 的 中 间 件 
























































Var User = require('../user'); a 
会 话 中 取出 已 登 ; 
module.exports = function(req, res, next)t 户 的 ID 
Var uid = req.session.uid; 
If (!Iuid) return next().; 从 Redis 中 取出 已 写 
User.get (uid, function(err, user)t 录用 户 的 数据 
if (err) return next (err); 
0 将 用 户 数据 输出 到 响 


和 应 对 象 中 


了 
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你 可 能 想 知 道 给 res.locals.user 分 配 了 什 和 o res .locals 是 Express 提 供 的 请 求 层 对 象 ， 
可 以 将 数据 输出 给 模板 ， 很 像 app .1ocals。 它 还 是 一 个 将 已 有 对 象 合并 到 其 目 吴 中 去 的 函数 。 

要 使 用 这 个 新 的 中 间 件 ， 首 先 要 删 掉 app.js 中 所 有 包含 文本 "user" 的 代码 。 然 后 像 往 稼 那样 
引入 模块 ， 把 它 传 给 app .use() 。 在 这 个 程序 中 ，usez 出 现在 路 由 需 上 面 ， 所 以 只 有 路 由 和 在 
user 下 面 的 中 间 件 能 访问 req.user。 如 采 你 正在 用 加 载 数 据 的 中 间 件 , 就 像 这 个 中 间 件 一 样 ， 
你 可 能 要 把 express .static 放 到 它 上 面 ; 否则 每 次 返回 静态 文件 时 ， 部 会 时 无 必要 的 到 数据 
库 中 取 一 次 用 户 数 据 。 

下 面 的 代码 清单 中 是 在 app.js 中 局 用 这 个 中 间 件 的 代码 。 


代码 清单 9-16 启用 用 户 加 载 中 间 件 


var user = require('./lib/middleware/user'); 























app.use (express.session())}),; 

app.use (express.static!( dirname + '/pPublic')).; 
app.use (user); 

app.use (messades ) ; 

app.use (app.router).; 


将 中 间 件 添加 到 程序 中 


如 果 你 再 次 启动 程序 ， 不 管 是 访问 /login 还 是 /register， 应 该 都 可 以 看 到 订单 。 如 果 你 想 给 羡 
单 增加 样式 ， 把 下 面 的 CSS 加 到 public/stylesheets/style.css 中 。 


代码 清单 9-17 可 以 加 到 style.css 中 给 菜单 添加 样式 的 CSS 


#menu { 
position: absolute; 
top: 15px; 
right: 20px; 
font-size: 12px; 
Color: #888; 

} 


#menu .name:after { 
content: ”一 


} 


#menu a { 
text-decoration: none; 
margin-left: Spx; 
colLor: black; 


} 
菜单 到 位 了 ， 你 应 该 可 以 目 己 注册 个 用 户 。 你 一 旦 注册 成 为 用 户 ， 应 该 束 可 以 看 到 汕 有 Post 
链接 的 EA 户 沫 单 。 
在 下 一 节 ， 你 将 在 添加 吼 吼 箱 消息 发 布 功能 时 学 到 更 和 匈 进 的 路 由 扩 术 。 
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9.2 先进 的 路 由 技术 


Express 路 由 的 主要 功能 是 匹配 URL 模 式 和 啊 应 逻辑 。 然 而 路 由 还 可 以 匹配 URL 模 式 跟 中 间 
件 。 这 样 你 可 以 用 中 间 件 给 特定 路 由 提供 可 重用 的 功能 。 

本 六 要 : 

口 用 特定 路 由 (route-specific ) 的 中 间 件 校 验 用 户 提 交 的 内 容 ; 

口 实现 特定 路 由 的 校 验 ; 

口 实现 分 页 。 

我 们 来 看 几 种 利用 特定 路 由 中 间 件 的 办 法 吧 。 


9.2.1 校 验 用 户 内 容 提 交 


为 了 让 校 验 有 用 武之 地 ， 我 们 最 后 给 这 个 吼 吼 箱 程 序 加 上 提交 消息 的 功能 。 次 加 这 个 功能 
需要 完成 下 面 几 项 工作 : 

口 创建 一 个 消息 模型 ; 

口 添加 与 消息 相关 的 路 由 ; 

口 创建 一 个 消息 表单 ; 

口 添加 用 提交 上 来 的 表单 数据 创建 消息 的 逻辑 。 

我 们 从 创建 消息 模型 开始 。 

1. 创建 消息 模型 

创建 包含 消息 模型 的 lib/entryjs 文 件 。 将 下 面 代码 清单 中 的 代码 放 到 这 个 文件 中 。 消 息 模 型 
跟前 面 创建 的 用 户 模 型 十 分 相似 ， 只 是 它 会 把 数据 存在 一 个 Redis 列 表 中 。 


代码 清单 9-18 ”消息 模型 





























var redis = require('redis'),; 
Var db = redis.createClient(); < 一 创建 Redis 客 户 端 实例 
module.exports = Entry; 了 < 一 从 模块 中 输出 Entry 函 数 
furnction Entry(oB]) 1 循环 遍历 传 入 对 象 中 的 键 
for (var key in obj) { 
this[key] = obj[keyl]; 
| | 合并 什 
} 
Entry.brototype.save = function (fn)t 将 保存 的 消息 转换 成 JSON 字 符 串 
Var entryJSON = JSON.stringify(this).; 
db. lpush ( 将 JSON 字 符 串 保存 到 Redis 
'entries', 列表 中 
entryJSoON, 


function(err) f{ 
1f (err) return fnt{err); 
Fr 

} 
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}; 
有 了 基本 的 模型 ， 现 在 你 需要 添加 一 个 名 为 getRange 的 困 数 ， 代 码 如 下 所 示 。 你 可 以 用 这 
个 冰 数 获取 消息 。 


代码 清单 9-19 ”获取 一 部 分 消息 的 逻辑 








Entry.getRange = function(from, to, fn)f{ 
db.lrange('entries', from, to, function(err, items)t 
if (err) return fnl(err); 用 来 获取 消息 记录 的 
Var entries = []; Redis lzrange 函 数 


jtems.forEach (function(item)t 


entries.push(JSON.parse (item) ) ; 网 网 
解码 之 前 保存 为 JSON 


的 消息 记录 


}); 


fn(null, entries); 
J 
} 。 


创建 好 模型 ， 现 在 你 可 以 往 列 表 中 添加 路 由 来 创建 消息 了 。 

2. 添加 与 消息 相关 的 路 由 

在 你 把 与 路 由 相关 的 路 由 添加 到 程序 中 之 前 ， 需 要 调整 一 下 app.js。 先 把 下 面 这 个 require 
语句 放 在 app.js 文 件 的 顶端 ; 

var entries = require('./routes/entries'); 

接 下 来 ,还 是 在 app.js 中 ， 修 改 包 含 app .get(' /的 那 行 代 码 ， 改 成 下 面 这 样 ， 让 发 给 /的 请 
求 返回 消息 列表 : 

app.get{('/', entries.list); 

现在 可 以 添加 路 由 逻辑 了 。 

3. 添加 显示 消息 的 首页 

从 创建 routes/entries.js 文 件 开 始 ， 把 下 面 的 代码 放 到 里 面 ， 引 入 消息 模型 ， 输 出 泻 染 消息 列 
表 的 函数 。 


代码 清单 9-20 ”消息 列表 











var Entry = require('../lib/entry'); 
exports.list = function(regq, res, next)t 
Entry.getRange(0, -1, function(err, entries) { < 一 获取 消息 


if (err) return next (err).; 


reg rendert" entriesg', < 一 泻 染 HTTP 响 应 
title: 'Entries', 
entries: entries, 
}); 
了 7 
} 


消息 列表 的 路 由 定义 好 了 ， 你 还 需要 添加 EJS 模 板 显 示 它 们 。 在 views 目 录 下 创建 一 个 名 为 
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entries.ejs 的 文件 ， 并 把 下 面 的 EJS 置 于 其 中 。 
代码 清单 9-21 修改 entries.ejs， 文 持 分 页 


<!IDOCTYPE html> 
<htmil> 
<head> 
<title><%= title %></title> 
<link rel='stylesheet' href='/stylesheets/style.css' /> 
</head> 
<body> 
< 名 include menu 各 > 


<%S emntties. forEachftunctionfenry) { %> 
<div class='entry'> 
<h3><%= entry.title %></h3> 
<p><%= entry.body %S></p> 
<p>Posted by <%= entry.username %></p> 
</dliv> 
<< 客 }】 针 > 
</body> 
</htmil> 


现在 运行 这 个 程序 , 首页 会 显示 消息 列表 。 然 而 我 们 还 没 创建 任何 消息 ,所 以 让 我 们 和 添加 
ee 


你 有 但 还 不 能 添加 它们 。 接 下 来 就 要 实现 这 一 功能 ， 先 把 下 面 的 代 


码 添加 到 app.js 的 路 由 部 分 : 
app.get{!/pPost!, entries.form).: 
app.post(!:/post!:, entries.submit),; 


接 看 把 下 面 的 路 由 添加 到 routes/entries.js 中 。 这 个 路 由 逻辑 会 泻 染 一 个 包含 表单 的 模板 : 


exports.form = function(regq, res})t{ 
res.render('post', { title: 'Post' }}); 
}; 


然后 用 下 面 清单 中 的 EJS 模 板 创 建 一 个 表单 模板 ， 并 把 它 存 为 views/post.ejs。 
代码 清单 9-22 可 以 输入 消息 数据 的 表单 


<!IDOCTYPE html> 
<html> 
<head> 
<title><%®= title %></title> 
<link rel='stylesheet' href='/stylesheets/style.css' /> 
</head> 
<body> 
< 委 lnclude menu %> 








<hl><%®= title %></hl> 
<pPp>Fill in the form below to add a new post.</p> 


<%S include messages %®> 
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<form action='/post' method='post'> 


六 


0 type='text' name='entryl[title]' placeholder='Title' /> 
</D> 
<p> 


</p> 


消息 主体 <textarea name='entrylbody]' placeholder='Body'></textarea> 
1 
| <p> 


<input type='submit' value='Post' /> 
< /人 > 
</form> 
</body> 
</html> 


表单 的 显示 做 好 了 ， 接 下 来 我 们 要 用 从 表单 中 提交 上 来 的 数据 创建 消息 。 

5. 实现 消息 创建 

要 用 从 表单 中 提交 上 来 的 数据 创建 消息 , 把 下 面 清 单 中 的 代码 添加 到 文件 routes/entries.js 中 。 
当 有 表单 数据 提交 上 来 时 ， 这 上 段 代码 会 添加 消息 。 


代码 清单 9-23 ”用 从 表单 中 提交 上 来 的 数据 创建 消息 
exports.submit = function(redq, res, next)t 
var data = red.body.entry; 


Var entry = new Entrytt 
username: res.locals.user.name, 
"titlje": data.title, 
"body'": data.body 

Ps 


entry.sSave (function(err}) { 
if (err} return next (err}; 
res.redirect{('/').; 
i 
}; 


现在 再 用 浏览 右 访 问 /post 时 ， 如 果 你 登录 了 ， 应 该 可 以 添加 消息 了 。 
那个 做 好 之 后 ， 我 们 接 下 来 要 看 一 下 特定 路 由 中 间 件 ， 以 及 如 何 用 它们 校 验 表 单数 据 。 


9.2.2 ”特定 路 由 中 间 件 


假定 你 想 将 消息 提交 表单 中 的 消息 文本 域 设 为 必 填 项 。 我 们 能 想到 的 第 一 种 方式 可 能 是 把 它 
直接 加 在 路 由 回调 函数 中 , 像 下 面 的 代 但 那样 。 然 而 这 种 方式 并 不 理想 ,因为 这 样 会 把 校 验 逻 辑 
绑 死 在 这 个 表单 上 。 大 多 数 情况 下 , 校 验 逻 辑 都 能 提炼 到 可 重用 的 组 件 中 , 让 开发 更 容易 、 更 快 、 
更 具 声 明 性 : 


exports.submit = function(regq, res, next)t 
var data = redq.body.entry; 




















if (idata.title) { 
res.error{({"Title is required.").; 
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res.redirect('back').: 
return; 


) 





if (data.title.length < 4) 1{ 
res.error{({"Title must be longer than 4 characters."); 
res.redirect('back').: 
etaril 


} 








Express 路 由 可 以 接受 它们 目 己 的 中 间 件 , 放 在 最 终 路 由 回调 水 数 之 前 , 只 有 跟 那 个 路 由 匹配 
时 才 会 调用 。 本 章 所 用 的 路 由 回调 并 没有 受到 特殊 街 遇 。 这 些 中 间 件 跟 其 他 中 间 件 一 样 ， 这些 你 
即将 创建 的 校 验 中 间 件 也 是 一 样 。 
我 们 先 来 看 一 种 简单 ， 但 严格 的 ， 用 特定 路 由 中 间 件 做 校 验 的 实现 方式 ， 以 此 作为 我 们 学 
习 特 定 路 由 的 开始 。 
1. 用 特定 路 由 实现 表单 校 验 
第 一 种 实现 方式 可 能 是 与 儿 个 简单 ,但 特定 的 中 间 件 组 件 执行 校 验 。 用 这 个 中 间 件 扩展 POST 
Ahpost 路 由 看 起 来 应 该 是 这 样 的 : 
apP.Post( ' /APoSst ' ， 
requireEntryTitle, 
requireEntryTitleLengthAbove(4), 


entries.submit 


1 
注意 前 面 这 个 路 由 定义 ,一般 的 路 由 定义 只 有 一 个 路 径 和 路 巾 逻 辑 作 为 参数 ， 而 这 个 路 由 定 
义 中 还 有 两 个 额外 的 参数 ， 这 两 个 额外 的 参数 是 校 验 中 间 件 。 
下 面 代码 中 的 两 个 中 间 件 阐明 了 如 何 把 原来 的 校 验 逻辑 妙 离 出 来 ,但 它们 的 模块 化 程度 还 不 
高 ， 并 且 只 能 用 在 输入 域 entry[title] 上。 


代码 清单 9-24 ”两 个 更 有 潜力 ， 但 仍 不 完美 的 校 验 中 间 件 尝试 
function regquireEntryTitle{treg, res, next} { 
var title = regq.body.entry.title; 
if {titjle) { 
next(}); 
} else { 
res.error{"Title is regquired."™); 
res.redirect{'back')}).: 
} 
} 
































function regquireEntryTitleLengthAbove(len) f{ 
return function{redq, res, next} { 

Var title = reg.body.entry.title; 

if {title.length > len) { 
next(}).;: 

} else { 
res.error{({'"Title must be longer than " + len); 
res.redirect{':back:).: 





图 灵 社 区 会 员 quqingtao 专 享 尊重 版 权 





204 第 9 章 ”Express 进 阶 


一 个 更 可 行 的 方案 是 将 校 验 天 剥离 出 来 , 把 目标 输入 域 的 名 称 传 给 它 。 我们 来 看 一 下 这 种 实 
现 方式 。 

2. 构建 灵活 的 校 验 中 间 件 

你 可 以 传人 输入 域名 称 ， 像 下 面 的 代码 这 样 。 这 样 你 可 以 重用 校 验 逻 辑 ， 减 少 需要 你 写 的 
代码 。 


apP.Poeostt /Pocst ' ， 
validate.regquiredt 'entry [title]'), 
validate.lJengthAbovel'entryltitlel]', 4), 
entries.submit).; 


把 app.js 文 件 中 路 由 部 分 的 app .post('/post'，entries.submit); 换 成 上 面 这 段 代码 。 
值得 一 提 的 是 ，Express 社 区 已 经 创建 了 很 多 类 似 的 公用 库 , 但 党 握 校 验 中 间 件 的 工作 机 制 ， 以 及 
如 何 编写 目 己 的 中 间 件 仍然 很 有 必要 。 

所 以 我 们 开始 吧 。 用 下 面 代 码 清 单 中 的 代码 创建 一 个 名 为 ./lib/middleware/validate.js 的 文件 。 
这 上 段 代 码 输 出 J 中 间 件 ， 具体 来 说 就 是 valigdate .requlired () 和 valigdate. lengthAbove()。 
这 里 的 实现 细节 并 不 重要 ; 关键 是 如 果 这 段 代码 在 程序 里 比较 通用 ， 那 这 一 小 部 分 工作 就 可 以 
发 挥 很 大 作用 。 
代码 清单 9-25 ” 校 验 中 间 件 的 实现 


function parseField(field)y { < 一 解析 entry [name] 符号 
return field 


:LIGNIN 


.filter(function(s){ return S }); 





















































} 
function getrField(req, field) { 
Var val = reg.body; 
field.forEach (function (prop)t 
val = val [lpropl]; 
Ia 
return val; 


} 


| 基于 parseriela() 的 结果 查找 属性 





exports.required = function (field)t 
field = parseField (field):; < 一 解析 输入 域 一 次 
return functionl(req, res, next)t 
—> if (getField(reqgq, fielgd)) { 
每 次 收 到 es < | 如 果 有 ， 则 进入 下 一 个 中 间 件 
请 求 都 检 } elge 4 
查 输 入 域 和 如 果 没 有 ， 显 示 
是 否 有 值 res.redirect('back'); | 错误 | 
} 
} 
}; 
exports.lengthAbove = function(field, len)t 
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field = parseField (field).; 
return function(req, res, next)t 
if (getField{reg, field}).length > len) f{ 





next():; 
} else { 
res.error(field.join(' ') + ' must have more than ' 
+ len + ' characters'); 


res.redirect{('back')}); 
} 
} 
} 


为 了 让 你 的 程序 用 上 这 个 中 间 件 ， 需 要 把 下 面 这 行 代码 放 到 app.js 的 顶部 : 

var validate = require('./lib/middleware/validate'); 

如 有 果 现 在 再 试 一 下 你 的 程序 ， 应 该 能 发 现 校 验 已 经 生效 了 。 这 个 校 验 API 还 可 以 更 顺畅 ,但 
这 个 驶 留 给 你 去 研究 了 。 

















9.2.3 ”实现 分 页 


分 页 是 男 一 种 适合 用 特定 路 由 实现 的 功能 。 本 节 会 写 一 个 小 型 的 中 间 件 函数 , 它 可 以 轻松 地 
实现 任何 资源 的 分 页 。 

1. 设计 分 页 API 

page() 中间 件 的 API 应 该 像 下 面 的 代码 一 样 ， 图 数 Entzry.count 会 找 出 消息 的 总 数 ，5$ 是 每 
页 显示 的 消息 条 数 ， 默 认 值 是 10。 在 apps.js 中 ， 把 app .get('/ 那 一 行 改 成 下 面 这 段 代 码 : 

app.get{'/', pagelEntry.count, 5), entries.list); 

为 了 让 程序 准备 好 接受 分 页 中 间 件 ， 把 下 面 这 段 代 码 加 到 app.js 的 项 部。 这 段 代码 会 引入 你 
即将 创建 的 分 页 中 间 件 和 消息 模型 : 


var page = require('./lib/middleware/page'): 
var Entry = require('./lib/entry'): 














接 下 来 实现 Entry .count () 。 这 在 Redis 中 很 简单 。 打 开 1lib/entryjs， 加 入 下 面 的 图 数 ， 它 用 
LLEN 命 令 取 得 列表 的 基数 ( 元素 的 数量 ): 
Entry.count = function(fn)f 


db.llen(l'entries', fn}.: 
完成 了 准备 工作 ， 可 以 实现 分 页 插件 了 。 
2. 实现 分 页 中 间 件 
为 了 分 页 ， 你 要 用 查询 字符 串 2page=N 来 确定 当前 页 面 。 把 下 面 的 中 间 件 函数 加 到 文件 ./lib/ 
middleware/page.js 中 。 
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代码 清单 9-26 分 页 中 间 件 


module.exports = function(fn, perpage)t 每 页 记录 条 数 的 默认 值 为 10 
perpage = perpage || 10; | 
return functionl(req, res, next)t ， 
< | 返回 中 间 件 函 数 
Var page = Math.max( 
、 parseInt (req.param('page') || '1', 10), 
让 入 、 
1 将 参数 page 解 析 为 十 进 制 的 
整 型 什 


fn(function(err, total)t 


. 1if (err) return next (err),; 
传递 错误 | 


redq.page = res.locals.page = { 


number: page, | 保存 page 属 性 以 便 将 来 引用 


perpage: perpage, 

from: page * perpage, 

to: page * perpage + perpage - 1, 
total: total, 

count: Math.ceil(total / perpage,) 


i “| 将 控制 权 交 给 下 一 个 中 间 伯 


}; 

代码 清单 9-26 中 的 中 间 件 抓 取 赋 给 ?page=N 的 值 , 比如 ?page=1。 然后 它 取得 结果 集 的 总 数 ， 
并 预先 计算 出 一 些 值 拼 成 page 对 象 ， 把 它 输 出 给 需要 演 染 的 视图 中 。 把 这 些 值 放 在 模板 外 计算 
可 以 减少 模板 中 的 逻辑 ， 保 持 模 板 的 整洁 性 。 

3. 在 路 由 中 使 用 分 页 器 

现在 要 更 新 entries.1ist 路 由 。 要 改 的 只 有 Entry.getRange(0，-1)， 用 page() 中 间 
件 定义 的 范围 换 到 原来 的 范围 ， 像 下 面 的 代码 这 样 : 

exports.list = function(req, res, next)t 

Var page = reg.page: 


Entry.getRange (page.from, page.to, functionl(err, entries)t 
if (err} return next (err).; 























req.param() 是 什么 ? 
regq.param() 类 似 于 PHP 的 S$_ REQUEST 关联 数组 。 你 可 以 用 它 检 查 查 询 衬 符 事 、 路 由 或 
请 求 主体 。 上 比如 说 ?page=1，/ :page 中 值 为 1 的 /1， 其 至 提交 的 JSON 数 据 {"page":1}, 在 
req.param 中 都 是 一 样 的 。 如 果 你 直接 访问 regq.query.page， 则 只 会 得 到 查询 字符 事 的 值 。 


4. 创建 分 页 链接 模板 
接 下 来 你 需要 给 分 页 导航 控件 做 个 模板 。 将 下 面 的 代码 添 加 到 . /views /pager.ejs 中 ， 这 
是 一 个 包含 上 一 页 和 下 一 页 按钮 的 简单 分 页 导航 控件 。 
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代码 清单 9-27 演 染 分 页 按钮 的 EJS 模 板 


*diyvy 1id='pager'> 只 有 一 页 时 不 显 
<% if (page.count > 1) { %> 示 分 页 控件 
如 果 没 在 nn 


<%$ If (page.number) { %> 





位 Ar 
种 一 页 ， 显 <a id='prev' href='/?page=<%= page.number %>'>Prev</a> 
示 上 一 页 站 ee 
链接 。 如 果 没 在 最 后 一 
过 J 女 <% 1f (page.number < page.count - 1) { %> 二 

本 - 页 ， 显 示 下 一 页 

<% 1f (page.number) { %> Po 

链接 


gnbsp; &nbsp; 
< 和 省 } %$> 


a id='next' href='/?page=<%= page.number + 2 %>'>Next</a> 
< 省 客 > 
和 


5. 在 模板 中 包含 分 页 链接 
分 页 中 间 件 和 分 页 模板 都 做 好 了 ， 你 可 以 用 EJS 的 includqe 指 令 把 分 页 模板 添加 到 消息 列表 
模板 ./views/entries.ejs 中 。 


代码 清单 9-28 ”修改 entries.ejs 包 含 分 页 
<!lIDOCTYPE html> 
<html> 
<head> 
<title><%= title %S></title> 
<link rel='stylesheet' href='/stylesheets/style.css' /> 


</head> 
<body> 


< 和 include menu 和 > 


<% entries.forEach(function(entry) { %> 
<div class='entry'> 
<h3><%= entry.title %®></h3> 
<pP><%S= entry.body %S></p> 
<p>Posted by <%= entry.username %></p> 
</div> 
< 省 ) 针 > 


< 委 linclude pager 各 > 


</body> 
</html> 


6. 让 分 页 链接 更 简洁 

你 可 能 在 想 如 何 只 用 路 径 名 访问 页 面 ， 比 如 用 /entries/2， 而 不 是 用 URL 参 数 ?page=2 访 
问 第 二 页 。 这 个 改 起 来 并 不 复 淋 ， 只 要 改 两 个 地 方 束 行 了 : 

(1) 修改 路 由 路 径 ， 让 它 可 以 接受 页 人 码 ; 

(2) 修改 页 面 模板 。 

第 一 步 是 修改 消 四 列表 路 由 ， 让 它 可 以 接受 路 径 中 的 页 码 。 你 可 以 调用 市 者 字符 串 / :page 
的 app.get() ， 但 你 可 能 还 想 让 /等 同 于 /0， 所 以 应 该 用 / :page? 让 页 人 码 变 成 可 选 的 值 。 在 路 由 
路 径 中 ，:page 这 样 的 东西 被 称 为 路 由 参数 ， 或 者 简称 为 params。 
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把 参数 设置 成 可 选 的 之 后 ，/15 和 /都 是 有 效 的 路 由 路 径 ， 中 间 件 page () 默认 的 页 码 是 1。 
因为 这 是 顶层 路 由 一 一 /5 而 不 是 /entries/5， 比 如 说 ， 参 数 :page 可 能 会 处 理 /upload 这 样 的 
路 由 路 径 。 一 种 简单 的 解决 办 法 是 把 这 个 路 由 定义 放 在 其 他 路 由 定义 下 边 。 让 它 做 最 后 一 个 路 由 
定义 。 这 样 更 具体 的 路 由 会 在 到 达 这 个 路 由 定义 之 前 找到 匹配 项 。 

首先 去 挥 app.js 中 原来 给 /定义 的 路 由 路 径 。 即 去 挥 下 面 这 行 代码 : 

app.get{('/', page{lEntry.count, 5), entries.1ist); 

接 春 把 下 面 的 路 由 路 径 添加 到 app.js 中 。 把 它 放 在 其 他 所 有 路 由 定义 下 面 : 

app.get{('/:page?', page{Entry.count, 5), entries.1ist); 

另外 一 个 需要 改 的 是 分 页 导航 模板 。 要 把 查询 字符 串 去 择 ， 让 页 码 成 为 路 径 的 一 部 分 ， 而 不 
是 URL 参 数 。 将 views/pager.ejs 改 成 下 面 这 样 : 


<div id='pager'> 








< 多 1f (page.count > 1) { %> 
<% if (page.number) { %®> 
<a lid='prev' href='/<%= page.number $$>'>Prev</a> 
< 客 } 针 > 
<$S if (page.number < page.count -~ 1}) { %$> 
<% if (page.number) { %®> 
tnbsp; tnbsp; 
< 千 】 和 > 
<a 1Q= nexXxt' href='/<%= page.number + 2 %>'>Next</a> 
< 】 SS> 
< 名 】 多 > 


</div> 


现在 启动 程序 ， 你 会 发 现 页 码 URL 更 简洁 了 。 
9.3 创建 一 个 公开 的 REST API 


本 节 会 为 吼 吼 箱 程 序 实现 一 个 RESTful 公 开 API, 让 第 三 方程 序 也 可 以 访问 和 添加 数据 , 按照 
REST 的 思想 ， 程 序数 据 是 可 以 用 谓词 和 名 词 ( 即 HTTP 方 法 和 URL ) 访问 和 修改 的 。REST 请 求 
返回 的 数据 一 般 是 机 需 可 读 的 格式 ， 比 如 JSON 或 XML 。 

实现 一 个 API 需 要 完成 下 面 这 些 任务 : 

口 设计 一 个 让 用 户 显 示 、 列 表 、 移 除 和 提交 消息 的 API ; 

口 添加 基本 认证 ; 

口 实现 路 由 ; 

口 提供 JSON 和 XML 啊 应 。 

能 对 请 求 认 证 和 签名 的 技术 有 很 多 种 , 但 实现 更 复杂 的 方案 超出 了 本 书 的 范围 。 为 了 阐明 如 
何 集成 认证 ， 我 们 使 用 Connect 目 带 的 中 间 件 basicauth () 。 








9.3.1 设计 API 











在 开始 痢 手 实现 之 前 , 先 理 清 芍 会 涉及 哪些 路 由 是 个 好 主意 。 在 这 个 程序 中 , 你 会 在 RESTful 
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API 的 路 径 前 加 上 /api, 但 你 可 以 根据 目 己 的 喜好 修改 这 个 设计 。 比 如 用 http://api.myapplication.com 
这 样 的 子 域名 。 

从 下 面 的 代码 来 看 ， 跟 在 app .VERB () 调用 里 定义 相 比 ,把 回调 函数 挪 到 单独 的 Node 模 块 里 
是 个 更 好 的 选择 。 这 个 单独 的 路 由 清单 让 你 对 你 和 你 的 团队 在 做 什么 , 以 及 实现 的 这 些 回调 在 哪 
里 一 目 了 然 : 


app.get{('/api/user/:id', apl.user); 
app.get{'/api/entries/:page?', apl.entries); 
app.pPost{l'/api/entry', api.addi}. 


9.3.2 添加 基本 的 认证 


之 前 说 过 ， 很 多 保证 API 安 全 和 限制 的 方式 都 不 在 本 书 的 讨论 范围 之 内 ， 但 对 基本 认证 的 处 
理 过 程 值得 我 们 介绍 一 下 。 

中 间 件 api .auth 对 这 个 处 理 做 了 抽象 ， 因 为 这 个 实现 会 放 在 即将 创建 的 ./routes/apijs 模 块 
中 。 如 果 你 还 能 回想 起 第 6 章 的 内 容 ， 应 该 记得 可 以 癌 app.use() 中 传人 路 径 名 。 这 是 挂 载 点 ， 
也 就 是 说 任何 以 /api 开 头 的 请 求 路 径 名 和 HTTP 请 词 都 会 导致 这 个 中 间 件 被 调用 。 

下 面 代码 片段 中 的 app .use('/api'，api.auth) 这 一 行 代 人 码 应 该 放 在 加 载 用 户 数据 的 中 
间 件 前 面 。 这 样 你 就 可 以 稍 后 再 修改 用 户 加 载 中 间 件 ， 为 已 认证 的 API 用 户 加 载 数 据 : 


var api = require('./routes/api'); 








app.usel('/api', api.auth).: 
app.usSe (user),; 








接着 创建 ./routes/apijs， 像 下 面 的 代码 片段 那样 引入 express 和 用 户 模 型 。 我 们 在 第 7 草 讲 过 ， 
basicAutn() 中间 件 以 一 个 咀 数 为 参数 执行 认证 ， 疯 数 签名 为 (username， password, callback).。 
你 的 User authentication 辆 数 非常 符合 这 一 要 求 : 


Var express = require('express'); 
var User = regquire('../lib/user').; 











exports.auth = express.basicAuth (User.authenticate).; 


认证 已 经 准备 好 了 ， 接 下 来 我 们 去 实现 API 的 路 由 。 





9.3.3 ”实现 路 由 


你 要 实现 的 第 一 个 路 由 是 GET /apiyvusery/:idq。 这 个 路 由 的 逻辑 必须 先 根 据 ID 取得 用 户 数 
据 ， 如 果 用 户 不 存在 ， 则 返回 404 Not Found 的 啊 应 状态 码 。 如 果 用 户 存在 ， 则 将 用 户 数据 传 给 
res.json() 做 串 行 化 处 理 ， 并 以 JSON 格 式 返 回 该 数据 。 将 下 面 的 代码 加 到 routes/api.js 中 : 


exports.user = function(reqgq, res, next)}t 








User.get (reqdq.params.id, function{err, user)f{ 
if (err} return next (err),; 
if {luser.id) return res.send(404). 


图 灵 社 区 会 员 quqingtao 专 享 尊重 版 权 





210 第 9 章 ”Express 进 阶 


res.json (user)}).; 
二 
?7 


再 把 下 面 的 代码 加 到 app.js 中 : 

app.get{'/api/user/:id', api.user); 

现在 可 以 测试 一 下 J。 

1. 测试 用 尸 数 据 获取 

启动 程序 ， 用 命令 行 工 具 cURL 测 试 它 。 下 面 的 代码 给 出 了 如 何 测 试 程序 的 REST 认 证 。 和 凭证 
tobi :ferret 在 URL 中 ，cURL 用 它 生 成 Authorization 请 求 头 域 . 








$ curl http://tobi:ferret@127.0.0.1:3000/api/user/l -Vv 


下 面 的 清单 是 测试 成 功 的 结 来 : 


代码 清单 9-29 ”测试 结 


* About to connect() to local port 80 (#0) 





* Trying 127.0.0.1... connected 

* Connected to local (127.0.0.1) port 80 (#0) 

» Server Sith Using Basie, WiIEh vser "tobi _ 显示 发 送 的 HTTP 头 
> GET /api/user/l1 HTTP/1.1 

> Authorization: Basic Zm9vYmFyYmF6Cg== 

> User-Agent: curl/7.21.4 (universal-apple-darwin1l1.0) libcurl/7.21.4 


OpenSSL/0.9.8r Zl1ib/1.2.5 
Host: local 
Accept: */* 

_ 显示 接收 到 的 HTTP 头 

HTTP/1.1 200 OK 
X-Powered-By: Express 
Content-Type: application/json; charset=utf-8 
Content-Length: 150 
Connection: keep-alive 


"人 人 人 人 信人 人 Vv yy 


_ 显示 接收 到 的 HTTP 数 据 


"name": "tobi", 
"Pass": 
"SS2as12SP.mzcfvmumS3MMOTEBN9wutfOEiywSXOVcGroeoVPGE7MLVtzZiYqK", 
noose VOT 
"salt": "$2as1l2sP.mzcfvmumS3MMOTEBN9wuU" 
} 


2. 去 掉 敏 感 的 用 户 数 据 
JSON 啊 应 里 把 用 户 的 密码 和 盐 都 输出 出 来 了 了。 要 改变 这 种 情况 ， 可 以 在 lib/userjs 中 的 
User .prototype 上 实现 .toJSON () : 


User.Drototype .toJSON = function()f 
return 1{ 
id: thigs, id, 
name: this.name 
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如 果 对 象 上 有 .toJSON，JSON.stringify， 就 会 用 它 返 回 的 JSON 格 式 。 如 果 再 次 发 送 之 
前 那个 cURL 请 求 ， 你 就 只 能 收 到 ID 和 name 属 性 了 . 


{ 
11d"-. ee 
"name": "tobi" 


] 

接 下 来 要 给 API 深 加 创建 消息 的 功能 。 

3. 添加 消息 

通过 API 凑 加 消息 的 处 理 和 通过 HTML 表 单 添 加 几乎 一 模 一 样 ， 所 以 你 很 可 能 还 会 用 之 前 实 
现 的 esntries.submit() 路 由 逻辑 。 

然而 在 诊 加 消息 时 ， 路 由 尿 辑 要 保存 用 户 名 ,， 染 加 消 县 和 其 他 细 玉 。 因 此 你 需要 修改 用 户 加 
载 中 间 件 ， 用 basicauth 中 间 件 加 载 的 用 户 数 据 组 装 res.locals.user。basicaAuth 中 间 件 把 
这 些 数据 存在 请 求 对 象 的 一 个 属性 上 : reg.remoteUser。 在 用 户 加 载 中 间 件 中 为 此 添加 一 项 检 
查 很 简单 : 只 要 按照 下 面 这 样 修改 lib/middleware/user.js 中 的 module .exports 定 义 ， 就 可 以 让 用 
户 加 载 中 间 件 能 跟 API 协 作 了 : 























module.exports = functionl(redq, res, next)}t 
if {reg.remoteUser) { 
res.locals.user = regq.remoteUser.; 
} 
var uid = req.session.uid; 
If (luid) return Dext ( ) :; 


User.get (uid, functionl(lerr, user)t 
if {err) return next (err); 
redq.user = res.locals.user = user; 
next (); 

Ji 

1 


改 了 这 个 之 后 就 可 以 通过 API 添 加 消息 了 。 
然而 还 有 一 个 地 方 要 改 ， 即 让 响应 适用 于 API， 而 不 是 重 定向 到 程序 首页 。 添 加 这 个 功能 需 
要 照 下 面 这 样 修改 routes/entries.js 中 的 entry .save: 





entry.save(function(err) { 
if (err) return next {err).;: 
It (req.remoteUser) { 
res.jsonl({message: 'Entry added.'}),; 
} else 1{ 
res.redirect('/'}); 
} 
上 








最 后 ， 为 了 诉 活 程序 中 的 消息 座 加 API， 将 下 面 的 代码 次 加 到 apijs 中 的 路 由 部 分 : 
app.post{'/api/entry', entries.submit).; 


使 用 下 面 的 cURL 命令 可 以 对 添加 消息 的 API 进 行 测试 。 这 里 发 送 的 标题 和 内 容 主 体 数 据 所 用 
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的 名 称 跟 HTML 表 单 输 入 域 的 名 称 相同 : 


$ curl -PR entryltitle]='Ho ho ho' -F entryl[lbody]='Santa loves you' 
http://tobi:ferret@127.0.0.1:3000/api/entry 


创建 消息 的 功能 已 经 加 上 上 了， 现在 该 添加 获取 消息 数据 的 功能 

4. 添加 消息 列表 支持 

你 接 下 来 要 实现 的 API 路 由 是 GET/api/entries/ :page?。 这 个 路 由 实现 跟 ./routes/entries.js 中 
的 消息 列表 路 由 几乎 是 一 模 一 样 的 。 你 将 和 前 面 一 样 使 用 page () 中 间 件 提供 的 zea.page 对 象 实 
现 分 页 。 

为 这 个 路 由 逻辑 要 访问 消息 ， 所 以 要 把 下 面 这 行 代 码 放 在 routes/api.js 的 顶部 引 和 人 Entry 
模型 : 











人 一 


和 

接 下 来 把 下 面 这 行 代 人 码 添 加 到 app.js 中 的 路 由 部 分 : 

app.get('/api/entries/:page?', page (Entry.count), api.entries); 

现在 把 下 面 的 代码 片段 添加 到 routesapi.js 中 。 这 上段 路 由 逻辑 和 routes/entries.js 中 对 应 逻辑 的 差 
别 在 于 它 不 表演 染 模板 了 ， 而 是 返回 了 JSON: 


exports.entries = function(req, res, next)})t 








var Vode = Te0 .bode 
Entry.getRange (page.from, page.to, functionlerr, entries})t 
if (err) return next (err).; 
res.json(entries),; 
jb 
} 四 


下 面 的 cURL 命令 会 从 API 中 请 求 消息 数据 : 
$ curl http://tobi:ferret@127.0.0.1:3000/api/entries 
这 个 cURL 命令 应 该 会 输出 类 似 下 面 这 种 的 JSON: 


| 
{ 


"usSername: "rick", 

"title": "Cats can't read minds", 

"body'": "I think you're wrong about 七 he cat thing." 
}， 
{ 

"USername"; "mike", 

"title": "I think my cat can read my mind", 

"body": "I think cat can hear my thoughts." 


Ts 





基本 的 API 实 现 已 经 做 完了 ， 接 下 来 我 们 去 看 看 如 何 让 API 文 持 多 种 啊 应 格式 。 


9.3.4 启用 内 容 协 商 
内 容 协商 让 客户 端 可 以 指定 它 乐于 接受 的 , 以 及 喜欢 的 数据 格式 , 在 本 节 中 , 你 会 提供 JSON 
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和 XML 格式 的 API 内 容 ，API 的 消费 者 可 以 决定 它们 想 要 什么 。 

HTTP 通 过 accept 请 求 头 域 提 供 了 内 容 协商 机 制 。 比 如 说 ， 某 个 客户 端 可 能 更 喜欢 HTML， 
但 也 可 以 接受 普通 文本 ， 则 可 以 这 样 设 定 请 求 头 : 

Accept: text/plain; dq=0.5, text/html 

qvalue 或 者 说 品质 值 (上 例 中 的 gq=0.5 ) 表明 即便 text/html 放 在 了 第 二 个 ， 它 的 优先 级 也 
要 比 text/plain 高 50%。 Express 会 解析 这 个 言 息 并 提供 一 个 规范 化 的 req .accepted 数 组 : 


[{ value: 'text/html', guality: 1 }, 
{ value: 'text/plain', guality: 0.5 }] 


Express 还 提供 了 res.format 1() 方 法 ， 它 的 参数 是 一 个 MIME 类 型 的 数组 和 一 些 回 调 函 数 。 
Express 会 决定 客户 端 愿意 接受 什么 格式 ， 以 及 你 愿意 提供 什么 ， 并 调用 相应 的 回调 函数 。 

1. 实现 内 容 协商 

实现 内 容 协 商 的 GET/api/entries 路 由 看 起 来 可 能 像 代 人 码 清单 9-30 一 样 。JSON 像 之 前 一 样 
得 到 了 支持 一 一 用 res .sena () 发 送 串 行 化 为 JSON 的 消息 数据 。XML 回 调 循环 遍历 消息 ， 并 把 
它 写 到 socket 中 。 注 意 ， 没 必要 显 式 设 定 Content-Type; res .format () 会 日 动 设 定 关 联 的 类 型 。 


代码 清单 9-30 ”实现 内 容 协商 

















exports.entries = function(req, res, next)t 
var page = req.page; _ 获取 消息 数据 
Entry.getRange (page.from, page.to, function(err, entries)t 


if (err) return next (err); 
基于 Accept 头 的 值 返 回 不 同 的 
res.format (1{ 响应 
'application/json': function()t 
res.send(entries); < 一 JSON 几 应 
Fg 


'application/xml': function()t 
eg, Write('<entries> Wn”):; < 一 XML 响应 
entries.forEach (function (entry)t 
res.write(' <entry>\n'); 
res.writel(' <title>' + entry.title + '</title>\n'); 
res.writel(' <body>' + entry.body + '</body>\n'); 
res.writel' <username>' + entry.username 


+ '</username>\n'),; 
res.writel(' </entry>\n'); 


py; 


res.end{'</entries>')}); 


a 
了 


如 末 你 设 定 了 一 个 默认 的 啊 应 格式 回调 ,如 采用 户 没 有 请 求 你 显 式 处 理 的 格式 ,会 执行 这 个 
默认 的 。 

res .format () 方 法 还 接受 扩展 名 ， 可 以 映射 到 相关 联 的 MIME 类 型 。 比 如 json 和 xml 可 以 
用 来 代替 application/ json 和 application/xml,， 就 像 下 面 的 代码 这 样 : 
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res.formatt{t 
json: function{}t 
res.send(entries),; 


J 


XmlL: function{)}t 
res.writet{'<entries>\n'}): 
entries.forpach (function (entry)f 








res.write{! <entry>\n!').; 

res.writert'’ titliesr | entrytitle 守 </titley vn) 
res.writel:! <body>! + entry.body + '</body>\n').; 

res,.writel! <USername>! + entry.username + '</username>\n').，: 
res.write(' </entry>\n'), 


}); 
res.end{'</entries>'); 
} 
}) 


2. XML 了 响应 

为 了 返回 XML 啊 应 而 在 路 由 中 编写 一 大 推定 制 代码 可 能 并 不 是 最 简洁 的 办 法 ， 所 以 我 们 要 
用 视图 系统 对 此 加 以 改善 。 

用 下 面 的 EJS 创 建 一 个 名 为 /views/entries/xml.ejs 的 模板 , 它 会 循环 遍历 消息 生成 <entry> 
标签 。 


代码 清单 9-31 用 EJS 模 板 生 成 XML 








<entries> 
<% entries.forEach (function(entry){ 各 > < 一 循环 遍历 每 条 消息 
<entry> 
输出 消息 中 <title><%= entry.title %></title> 
的 名 个 域 <body><%= entry.body %></body> 
<username><%= entry.username %></username> 
</entry> 


< }) 和 > 
</entries> 


现在 你 可 以 用 一 个 带 消 息 数 组 参数 的 res.render0 调 用 取代 XML 回 调 ， 代 码 如 下 所 示 : 


xml: function()}t 








res.render('entries/xml', { entries: entries }); 
} 
}) 


现在 你 可 以 测试 XML 版 本 的 API 了 。 输 入 下 面 的 命令 行 看 看 输出 的 XML : 


CuUurl] -1 -H 'Accept: application/xml' 
http://tobi:ferret@127.0.0.1:3000/api/entries 


9.4” 误 处 理 


到 目前 为 止 ， 不 管 是 程序 本 里 还 是 API， 虱 没有 返回 错误 或 404 Not Found 的 啊 应 。 也 就 是 说 
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如 果 没 找到 请 求 的 资源 ， 或 者 数据 库 连 接 断 掉 了 ， Express 会 分 别 返 回 默认 的 404 或 500 响 应 。 如 
图 9-8 所 示 ， 这 对 用 户 来 说 不 太 友 好 ， 所 以 我 们 要 给 出 定制 的 错误 啊 应 。 你 要 在 本 节 中 实现 404 和 
错误 中 间 件 ， 用 客户 端 可 接受 的 HTML 、JSON 或 普通 文本 格式 返回 错误 响应 。 








让 
人 OA <$- http:/ /tobi.ferret@local/m: 


生 © | © local/maru/the/cat w|i 





Cannot GET /maru/the/cat 





图 9-8 一 个 标准 的 Connect 404 错 误 消 息 


我 们 从 未 找到 的 资源 开始 ， 先 实现 一 个 404 中 间 件 。 
9.4.1 ”处理 404 错误 


如 前 所 述 ， 当 Connect 穷 尽 所 有 中 间 件 仍 没 找到 响应 项 时 ， 它 会 用 404 和 一 小 段 普通 文本 字符 
串 作 为 啊 应 。 看 起 来 就 像 下 面 这 种 对 并 不 存在 的 条 目的 啊 应 : 


$ curl http://tobi:ferret@127.0.0.1:3000/api/not/a/real/path -i 
-H "Accept: application/json" 


HTTP/1.1] 404 Not Found 
Content-Type: text/plain 





Connection: keep-alive 





Transfer-Encoding: chunked 





Cannot GET /api/not/a/real/path 
根据 你 的 需要 ， 可 能 这 个 更 好 接受 ， 但 理想 的 JSON API 会 用 JSON 作 为 啊 应 ， 像 下 面 这 段 代 
但 一 样 : 
$ curl http://tobi:ferret@127.0.0.1:3000/api/not/a/real/path 
-i -H "Accept: application/json" 
HTTP/1.1 404 Not Found 
Content-Type: application/json; charset=utf-8 


Content-Length: 37 
Connection: keep-alive 





{ "message'": "Resource not found'" } 

实现 404 中 间 件 没什么 特别 的 ， 不 管 是 Connect 还 是 Express， 这 都 很 普通 。404 中 间 件 函数 就 
是 用 在 其 他 所 有 中 间 件 函数 之 后 的 普通 函数 。 如 果 到 它 那 里 了 , 你 可 以 肯定 不 会 有 其 他 任何 东西 
想 要 给 出 啊 应 了 ， 所 以 你 可 以 继续 加 前 ， 泻 染 一 个 模板 ， 或 者 以 你 喜欢 的 方式 啊 应 。 

图 9-9 展 示 了 一 个 你 即将 为 404 错 误 创建 的 HTML 响 应 。 
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@0og <$- 404 Not Found 


人 入 © | © local/maru/the/cat 了 





404 Not Found 


Sorry we can't find that! 











图 9-9” 比 标准 的 Connect 404 消 息 看 起 来 更 直观 的 404 错 误 消息 


1. 添加 一 个 返回 错误 响应 的 路 由 

打开 .outesindex.js。 目 前 这 个 文件 中 只 有 express (1) 最 初生 成 的 exports .index 邮 数 。 
你 可 以 删 掉 它 了 了， 因为 它 已 经 被 entries.1ist 取 代 了 。 

错误 啊 应 负数 的 实现 取决 于 你 的 程序 需要 什么 。 在 下 面 的 代码 片段 中 , 你 将 用 res . format () 
的 内 容 协商 方法 向 客户 端 提供 text /html、application/json 和 text/plain 响 应 , 看 他 们 喜 
欢 哪 个 。 啊 应 方法 res .status (code) 跟 设 定 Node 的 res.statuscode = code 属 性 一 样 ， 但 
因为 它 是 个 方法 ， 所 以 可 以 链 起 来 ， 就 像 你 马上 在 下 面 代 码 中 见 到 的 .format () 调用。 


代码 清单 9-32 Not Found 的 路 由 好 辑 


exports.notfound = function(req, res})t 
res.status (404) .format{(t 
html: function()}t 
res.render('404').; 
上 


json: function(}t 























res.send({ message: 'Resource not found' }}); 
}， 
xml: function() { 
res.write{('<error>\n').; 
res ,writerl,! <message>Resource not found</message>\n'); 
res.end{('</error>\n').; 


text: function({(}t 
res.send('Resource not found\n'}): 


}; 
2. 创建 错误 页 面 模 板 

你 还 没 创建 404 的 模板 呢 , 所 以 请 创建 一 个 名 为 /views/404.ejs 的 新 文件 , 放 入 下 面 的 EJS 代 码 。 
模板 的 设计 完全 由 你 做 主 。 
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代码 清单 9-33 ” 404 页 面 样本 
<!IDOCTYPE html> 
<html> 
<head> 
<title>404 Not Found</title> 
<link rel='stylesheet' href='/stylesheets/style.css' /> 
</head> 
<body> 
< include menu %> 


<h1i>404 Not Found</h1l> 
<p>Sorry we can't find thatl!</p> 
</body> 
</html> 


3. 局 用 这 个 中 间 件 
把 *outes .not found 中 间 件 加 在 其 他 中 间 件 下 面 , 然后 耽 可 以 按 你 的 期 望 处 理 404 错 误 了 


apb.uselapp.router): 
app.uselroutes.notfound)}; 


现在 你 可 以 按 风格 处 理 404 了 ， 接 下 来 我 们 要 实现 一 个 定制 的 错误 处 理 中 间 件 组 件 ， 以 便 在 
错误 出 现时 给 用 户 提供 更 好 的 体验 。 











9.4.2 ”处 理 错误 


到 目前 为 0 给 next () 。 但 Connect 默 认 会 用 5$00 服 务 器 内 部 错误 作为 响应 ， 跟 默 
认 的 404 啊 应 很 像 。 通 各 来 说 ， 不 应 se 端 ， 因 为 可 能 会 双 露 安全 漏洞 ， 但 
这 个 默认 的 啊 应 对 Pe te 问 者 也 没什么 价值 。 
本 市 中 会 创建 一 个 通用 的 5xx 模 板 , 在 有 错误 发 生 时 用 它 来 生成 给 客户 问 的 啊 应 。 当 客户 端 可 
以 接受 HTML 时 , 它 会 提供 HTML 啊 应 , 而 对 于 那些 接受 JSON 的 , 比如 API 的 使 用 者 , 则 提供 JSON。 
只 要 你 喜欢 ， 中 间 件 明 数 放 在 哪里 都 行 ， 但 现在 先 放 在 .routesyindex.js 中 吧 ， 让 它 挨 着 404 部 
数 。 这 里 和 exports.erzor 中 间 件 的 主要 区 别 是 它 有 四 个 参数 ， 我 们 在 第 6 章 讲 过 ,错误 处 理 中 
Wi 四 个 参数 ， 不 能 多 也 不 能 少 。 
1. 用 条 件 路 由 测试 错误 页 
如 果 你 的 程序 够 健壮 ， 可 能 很 难 触 发 错误 。 因 此 有 必要 创建 一 个 条 件 路 由 。 这 些 路 由 只 能 通 
环境 变量 或 环境 类 型 ( 比如 在 开发 时 ) 局 用 。 
面 这 段 代码 出 自 app.js， 它 在 指定 环境 变量 ERROR_ROUTE 时 添加 /dev/error 路 由 ， 可 以 
用 er. we 把 这 段 代 码 添加 到 app.js 的 路 由 部 分 : 


if (Process.env.ERROR _ ROUTE) { 
abppP.Gdetl ' /devAerror ' ，functlonred，res，neXt){ 
Var err = new Errorl'database connection failed').， 



































err.type = 'database': 
next (err};: 
了 
} 
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这 个 到 位 后 ,可 以 用 下 面 的 命令 启动 这 个 带 有 可 选 路 由 的 程序 。 如 果 你 觉得 好 奇 ， 可 以 先 在 
浏览 妖 中 访问 一 下 /dev/error， 不 过 一 会 儿 你 就 会 用 它 测试 错误 处 理 述 : 

$ ERROR_ ROUTE=1 node app 

2. 实现 错误 处 理 器 

代码 清单 9-34 中 的 代码 是 错误 处 理 需 的 实现 ， 把 它 放 在 .routes/index.js 中 ， 错 误 处 理 融 一 开 
始 就 调用 console.error (err.stack)。 这 可 能 是 这 个 也 数 中 最 重要 的 一 行 代 码 。 当 有 错误 从 
Connect 中 传 过 来 时 ， 它 可 以 确保 你 能 知道 。 销 误 消 号 和 堆栈 跟踪 会 被 写 到 stderr 流 中 以 备 后 续 查 看 。 


代码 清单 9-34 ”市 内 容 协 丙 的 错误 处 理 带 








exports.error = function(err, reg, res, next)t 错误 处 理 器 必须 
onsole. Serrnorlerr: stack) > 有 四 个 参数 
var msg; 
将 错误 输出 i | 
zy switc err.type NE 
Ee case 'database': | 县 体 的 错误 示例 
msg = 'Server Unavailable'; 
res.statusCode = 503; 
break,; 
default: 
msg = 'Internal Server Error';} 


res.statusCode = 500,， 


| 


res.formatl(t 
html: function()t 


可 以 接受 HTML 时 
泻 染 模板 


res.render('Sxx', { msg: msg, status: res.statusCode }); 

}, 

jons functionm() 可 以 接受 JSON 时 
res.send({ error: msg }); 发 送 的 响应 

J 

text: function()t 响应 普通 文本 
res.send (msg + '\n'),， 


}3 
为 了 给 用 户 一 个 更 有 意义 的 响应 , 但 又 不 暴露 给 定 错误 的 过 多 信息 ,你 可 能 想 要 相应 地 检查 
呵 应 和 错误 的 属性 。 这 上段 代码 对 你 在 /dev/error 中 由 中 添加 的 err .type 属 性 做 了 检查 ， 以 便 可 以 
定制 错误 消息 ， 并 确定 用 HTML 、JSON 还 是 普通 文本 发 送 响应 ， 非 常 像 404 处 理 需 。 
程序 错误 警告 ”这 个 统一 的 错误 处 理 器 特别 适合 完成 与 错误 处 理 相关 的 任务 ， 比 如 
向 你 的 团队 发 出 警告 , 告诉 他 们 有 地 方 出 错 了 。 自己 试 一 下 吧 : 选 一 个 第 三 方 邮件 模块 ， 
写 一 个 通过 邮件 给 你 发 送 和 警告 的 错误 处 理 中 间 件 ,并 调用 next (err) 将 错误 传 给 后 续 的 
错误 处 理 中 间 件 。 
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3. 创建 错误 页 面 模板 
res .render ('5xx') 里 用 的 EJS 模 板 放 在 ./views/5xx.ejs 中 ， 人 代码 如 下 所 示 : 


代码 清单 9-35 ” 500 错误 页 面 样 本 


<IDOCTYPE html> 
< 用 tm] > 
<head> 





<title><%$= status S$> <$= msg %S></title> 

<link rel='stylesheet' href='/stylesheets/style.css' /> 
</head> 
<body> 

<$%S include menu %®> 


< 了 > 去 车 = status 第 > Error</hl> 
<P><%$= msg S$></pPp> 
<D> 
Try refreshing the page, if this problem 
persists then we're already working on 1it! 
</D> 
</body> 
</html> 


4. 启用 中 间 件 


编辑 app.js ， 把 routes .error 放 在 其 他 中 间 件 下 面 ， 包括 routes .notfound， 你 要 确保 
Connect 能 看 到 的 所 有 错误 ， 其 至 是 routes. notfound 中 的 潜在 错误 ， 者 9 月 E 到 达 这 个 中 间 件 : 





人 
app.use (routes.notfound)}; 
app.use (routes.error); 


}); 
启用 ERROR_ROUTE 上 骨 次 启动 程序 ， 看 一 下 图 9-10 中 新 的 错误 页 面 。 











] @ OO 日 <$ 503 Server Unavailable 
€ © | © local/dev/error Lr 
503 Error 


Server Unavailable 


Try refreshing the page, if this problem persists then we're already working on it! 


图 9%-10 ”错误 页 面 


你 已 经 做 好 了 一 个 功能 完备 的 吼 吼 箱 程 序 ， 还 在 这 个 过 程 中 学 到 了 一 些 基 本 的 Express 开 发 
技术 。 
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9.5 小 结 


你 在 本 章 中 构建 了 一 个 简单 的 Web 程 序 , 用 到 了 Express 中 的 很 多 功能 , 都 是 在 前 一 章 没 接触 
过 的 。 在 本 章 中 学 到 的 技术 应 该 可 以 让 你 在 Web 程 序 开 发 工作 中 更 进一步 。 

你 先 创 建 了 一 个 通用 的 用 户 认 证 和 注册 系统 , 用 会 话 保存 已 登录 用 户 的 ID, 以 及 系统 要 显示 
给 用 户 的 所 有 消息 。 

然后 你 通过 中 间 件 创建 了 一 个 REST API， 又 用 到 了 这 个 认证 系统 。REST API 将 选 定 的 程序 
数据 输出 给 开发 人 员 ， 然 后 通过 内 容 协商 ， 提 供 JSON 或 XML 格式 的 数据 。 

我 们 用 了 两 草 的 篇 幅 磨 练 你 的 Web 程 序 开发 技能 ， 接 下 来 你 可 以 重点 人 研究 一 个 对 所 有 Node 
开发 都 很 有 帮助 的 课题 : 自动 化 测试 。 
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测试 Node 程 序 


本 章 内 容 

口 用 Node 的 assert 模 块 测试 逻辑 
口 使 用 Node 单 元 测试 框架 

口 用 Node 模 拟 和 控制 浏览 3 





在 添加 程序 特性 时 ， 你 也 可 能 会 引入 bug。 没 经 过 测试 的 程序 是 不 完整 的 ， 而 手工 测试 很 楷 
珀 ， 又 容易 出 现 人 为 错误 ， 所 以 目 劲 测试 变 得 越 来 越 流行 。 目 劲 训 试 需要 编 与 测试 代码 的 逻辑 ， 
而 不 是 手动 运行 程序 程序 的 功能 。 

如 末 你 之 前 没 接触 过 目 动 测试 的 理念 , 你 可 以 把 这 个 想象 成 有 个 机 各 人 在 帮 你 做 那些 乏味 的 
工作 ， 而 你 可 以 集中 精力 做 些 有 趣 的 事情 。 你 每 次 修改 代码 ， 这 个 机 各 人 虱 可 以 确保 没有 bug 汐 
进来 。 尽管 你 可 能 还 没有 完成 或 开始 你 的 第 一 个 Node 程 序 , 但 这 并 不 妨碍 你 掌握 如 何 实现 自动 化 
测试 ， 因 为 你 可 以 边 开 发 边 写 测试 。 

本 章 会 介绍 两 种 目 动 化 测试 : 单元 测试 和 验收 测试 。 单 元 测试 卫 接 测试 代码 逻辑 , 通常 是 在 
员 数 或 方法 层面 ,适用 于 所 有 类 型 的 程序 ,单元 测试 方法 可 以 分 为 两 大 形态 :测试 驱动 开发 ( TDD ) 
和 行为 驱动 开发 ( BDD )。 实 事 求 是 地 讲 ，TDD 和 BDD 大 致 是 相同 的 ， 它 们 的 区 别 主 要 体现 在 用 
来 描述 测试 的 语言 上 ， 你 看 过 几 个 例子 就 明白 了 。TDD 和 BDD 还 有 其 他 区 别 , 但 那 不 在 本 书 要 讨 
论 的 范 玮 之 内 。 

验收 测试 是 额外 的 测试 层 ， 在 Web 程 序 上 用 的 很 普 志 。 验 收 测试 用 脚本 控制 浏览 项， 并 试图 
用 它 触 发 Web 程 序 的 功能 。 

我 们 将 会 看 到 为 单元 和 验收 测试 建立 的 解决 方案 。 对 于 单元 测试 ， 我 们 会 介绍 Node 的 assert 
模块 和 Mocha、nodeunit、Vows 以 及 should.js 框 架 。 对 于 验收 测试 , 我 们 会 看 一 下 Tobi 和 Soda 框 染 。 
图 10-1 把 这 些 工具 和 它们 各 目的 测试 方法 及 口味 放 到 了 一 起 。 

我 们 先 从 单元 测试 开始 吧 。 
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测试 程序 逻辑 测试 程序 界面 和 功能 


单元 测试 验收 测试 


Tobi 
TDD 口 味 BDD 口 味 Soda 


Mocha Mocha 
nodeunit WoWwS 
assert 模块 should.js 





传统 的 
单元 测试 


更 容易 
看 懂 





图 10-1 测试 框架 概览 


10.1 单元 测试 


单元 测试 是 这 样 一 种 目 动 化 测试 , 你 编写 逻辑 测试 程序 中 的 各 个 部 分 。 编写 测试 让 你 更 认真 
地 思考 你 的 程序 设计 选择 , 帮 你 尽早 避 开 各 种 陷阱 。 测试 还 让 你 相信 你 最 近 做 出 的 修改 没有 引入 
错误 。 尺 管 单元 测试 需要 提前 做 些 编写 工作 ,但 你 不 用 在 每 次 修改 程序 后 都 要 重新 手动 测试 它 ， 
所 以 它 可 以 节省 你 的 时 间 。 

单元 测试 可 能 会 比较 环 手 ， 而 异步 逻辑 又 市 来 了 新 的 挑战 。 异 步 单元 测试 可 以 并 行 运行 ,所 
以 你 必须 小 心 ， 确 保 测 试 不 会 相互 干扰 。 比 如 说 ， 如 果 你 的 测试 在 人 硬盘 上 创建 了 一 个 临时 文件 ， 
在 完成 测试 后 删除 文件 时 一 定 要 并 愤 , 不 要 删 掉 另外 一 个 未 完成 测试 正在 使 用 的 文件 。 因 此 很 多 
单元 测试 框架 都 有 流程 控制 ， 可 以 让 测试 按 顺 序 运 行 。 

本 节 会 加 你 展示 如 何 使 用 : 

口 Node 内 置 的 assert 模 块 ” TDD 风格 目 动 化 测试 的 好 工具 ; 

口 nodeunit 长 期 以 来 都 能 得 到 Node 社 区 喜爱 的 TDD 风 格 测试 工具 ; 

口 Mocha 相对 比较 新 的 测试 框架 ， 可 以 用 来 做 TDD- 或 BDD- 风 格 的 测试 ; 

口 Vows 得 到 广泛 应 用 的 BDD 风 格 测试 工具 ; 

口 should.js 构建 在 Node assert 模 块 之 上 的 模块 ， 提 供 BDD 风 格 的 断言 。 

我 们 先 从 assert 模 块 开 始 吧 ， 这 个 是 Node 内 置 的 。 











10.1.1 assert 模 块 





大 多 数 的 Node 单 元 测试 都 是 基于 内 置 的 assert 模 块 ， 它 可 以 测试 条 件 ， 如 采 条 件 未 满足 ， 则 
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抛 出 错误 。 很 多 第 三 方 测试 框架 都 用 了 Node 的 assert 模 块 ， 但 即便 没有 测试 框架 ， 你 仍然 可 以 用 
它 做 测试 。 


1. 一 个 简单 的 例子 

假设 你 有 一 个 人 简单 的 待 办 事项 程序 , 把 事项 存在 内 存 里 , 并 且 你 要 断言 它 做 的 是 你 认为 它 在 
做 的 。 

下 面 的 代码 清单 中 定义 了 一 个 模块 ,包含 程序 的 核心 功能 ,模块 的 逻辑 支持 待 办 事项 的 创建 、 
获取 和 删除 。 它 还 包含 了 一 个 简单 的 daoasync 方 法 ， 所 以 我 们 还 可 以 看 到 对 异步 方法 的 测试 。 我 
们 把 这 个 文件 命名 为 todo.js。 


代码 清单 10-1 待 办 事项 清单 的 模型 
fumetion -Tod () A < 一 定义 待 办 事项 数据 库 
this.todos = []; 
} 


Todo.prototype.adqd = function (item) { < 一 添加 待 办 事项 
if (!item) throw new Error('Todo#tadd requires an item') 
this.todos.push (item); 

} 


Todo.prototype.deleteAll = function () { < 一 删除 所 有 的 待 办 事项 
this.todos = []; 
} 


Todo.prototype.getCount = function () { < 一 取得 待 办 事项 的 数量 
return this.todos.length; 
. 


TOUG DrotoLvie. dOAByne = Tunotion (ep 4 < 一 两 秒 后 带 着 "true" 调 用 回调 
setTimeout (ch, 2000, true); 
} 


module.exports = Todo; < 一 输出 Todo 取 数 

接 下 来 你 可 以 用 Node 的 assert 模 块 测试 这 上 段 代码。 

在 testjs 文 件 中 输入 下 面 的 代码 ， 加 载 必要 的 模块 ， 设 置 一 个 新 的 待 办 事项 清单 ， 并 设 定 一 40 
个 变量 追踪 测试 的 进展 。 


代码 清单 10-2 设置 必要 的 模块 


Var assert = regquire('assert').， 
var Todo = regquire{'./todo').,; 
var todo = new Todo(); 





var testsCompleted = 0; 

2. 用 equal 测 试 变量 的 内 容 

接 下 来 你 可 以 给 竺 办 事项 程序 的 删除 功能 添加 一 个 测试 。 

注意 代码 清单 10-3 中 equal 的 用 法 。equal 是 assert 模 块 中 用 的 最 多 的 断言 ， 它 判断 变量 的 内 
容 是 否 确 实 等 于 第 二 个 参数 指定 的 值 。 这 个 例子 创建 了 一 个 待 办 事项 ， 然 后 把 所 有 事项 都 删 挥 。 
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代码 清单 10-3 测试 以 确保 删除 后 没 留 下 符 办 事项 


function deleteTest () { 届 


todo.aqd ("Delete Me 以 便 测 试 删除 断言 数据 被 
SBSect equal (todo.getCount()}, 1; ‘1 item Snoula exigst'); 正确 添加 
todo.deleteAll(); 
删除 所 ， ， 
有 记录 assert.equal (todo.getCount(), 0, 'No items should exist'); 断言 记录 
testsCompleted++; 已 被 删除 


， ”| 记录 测试 已 完成 
为 在 测试 的 最 后 应 该 没有 竺 办 事项 了 ， 所 以 ， 如 果 程 序 逻 辑 能 够 正和 并 工作 的 话 ， 
toqo .getcount () 的 值 应 该 是 0。 如 果 出 了 问题 ， 会 有 异常 抛 出 。 如 果 变 量 toqo .getCount () 
不 是 0， 这 个 断言 会 在 堆栈 跟踪 中 显示 一 条 错误 消息 ， 在 控制 台中 输出 “No items should exist,” 
在 断言 之 后 ，testsCcompleted 加 一 ， 记 录 测 试 已 经 完成 了 。 
3. 用 NOTEQUAL 找 出 逻辑 中 的 问题 
把 下 面 的 代码 添加 到 testjs 中 。 这 段 代 码 测 试 的 是 竺 办 事项 程序 的 添加 功能 。 


代码 清单 10-4 测试 以 确保 竺 办 事项 添加 能 用 





function addTest () { 
todo.deleteAll (); < 一 删除 之 前 所 有 的 事项 
断言 之 前 有 todo.add('Added'); < 一 添加 事项 
事项 存在 assert.notEqual (todo.getCount(), 0, '1 item should exist'); 
testsCompleted++; < 一 记录 测试 已 完成 


} 

assert 模 块 中 也 可 以 使 用 notEqual 上 晰 言 。 当 程序 要 产生 确定 的 值 时 ,用 这 种 断言 可 以 表明 逻 
辑 中 有 问题 。 

代码 清单 10-4 中 给 出 了 notEqual 央 言 的 用 法 。 所 有 的 竺 办 事项 都 被 删除 了 ， 然 后 又 添加 了 
一 个 事项 ,程序 逻辑 再 取得 所 有 事项 。 如 采 事 项 的 数量 为 0， 靳 言 就 会 失败 并 抛 出 异常。 

4. 使 用 增加 的 功能 : STRICTEQUAL、NOTSTRICTEQUAL、DEEPEQUAL、NOTDEEPEQUAL 

除了 equal 和 notEqual，assert 模 块 还 提供 了 这 两 个 断言 的 严格 版 本 : strictEqual 和 
notstrictEqual。 它们 使 用 严格 的 相 秆 操 作 符 (=== )， 而 不 是 更 随和 的 ==。 

为 了 比较 对 象 , assert 模 块 提供 了 deepEqual 和 notDeepEqual。 这 些 断 言 名 称 中 的 deep 表 明 它 
们 会 递归 地 比较 两 个 对 象 ， 比 较 两 个 对 各 的 属性 ， 如 果 属 性 也 是 对 象 ， 则 会 继续 比较 属性 的 属性 。 

5. 用 OK 测试 异步 值 是 否 为 TRUE 

现在 是 时 候 给 竺 办 事项 程序 的 doAsync 方 法 话 加 一 个 测试 了 ,代码 如 清单 10-5 所 示 。 因 为 这 
是 一 个 异步 测试 , 我 们 提供 了 一 个 回调 函数 (cb ) 来 癌 测试 运行 者 发 送 测试 结束 的 信号 一 一 我 们 
不 能 像 同步 测试 那样 菲 孔 数 返回 来 表明 测试 结束 了 。 要 看 doAsync 的 结果 值 是 否 为 true， 我 们 
用 的 是 ok 潜 言 。ok 源 言 可 以 很 容易 地 测试 一 个 值 是 否 为 true。 


代码 清单 10-5 ”测试 看 doAsync 回 调 传 人 的 是 否 为 true 

















function doAsyncTest (cpb) { 两 秒 后 
todo.doAsync (function (value) { 激活 回调 
assert.ok(value, 'Callback should be passed true'); < | 断言 值 为 true 
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testsCompleted++; 记录 测试 已 完成 
人 完成 后 激活 
回调 函数 


} 

6. 测试 能 否 正 确 抛 出 错误 

你 还 可 以 用 assert 模 块 检查 程序 能 否 正 确 抛 出 错误 消息 ， 像 下 面 的 代码 这 样 。throws 语 人 句 中 
的 第 二 个 参数 是 一 个 正则 表达 式 ， 在 错误 消息 中 查找 文本 “requires”。 


代码 清单 10-6 ”测试 看 缺少 参数 时 add 是 否 会 抛 出 错误 
function throwsTest (cb) { 
SSGE throws(todo.add, /regquires/}); < 一 不 带 参 数 调 用 todo .add 
testsCompletedt+ 了 一 记录 测试 已 完成 
} 


7. 添加 逻辑 运行 你 的 测试 
测试 已 经 定义 好 了 , 现在 你 可 以 把 逻辑 添加 到 文件 中 运行 这 些 测试 。 下 面 的 代码 会 运行 前 面 
定义 的 所 有 测试 ， 并 输出 有 多 少 测试 运行 并 完成 了 。 


代码 清单 10-7 运行 测试 并 报告 测试 完成 











deleteTest(); 

addTest ( ) ; 

throwsTest().; 

doAsyncTest (function () { 表明 结束 
console.log('Completed ' + testsCompleted + ' tests'); 的 测试 


1 

你 可 以 用 下 面 的 命令 运行 这 些 测试 : 

$s node test.js 

如 果 没 有 测试 失败 , 这 段 脚 本 会 告诉 你 已 完成 的 测试 数量 。 退 踊 测试 的 开始 和 结束 时 间 可 能 
也 很 明智 ， 可 以 防止 单个 测试 中 的 缺陷 。 比 如 说 ， 某 个 测试 可 能 没有 执行 到 呆 言 。 

为 了 使 用 Node 的 内 置 功能 , 每 个 测试 郡 要 包含 很 多 套路 化 的 代码 设置 测试 ( 比如 删除 所 有 事项 )， 
追踪 测试 进程 (“ 已 完成 ”计数 带 ) 这 些 套 路 化 的 代码 让 你 把 工作 重心 俩 移 到 了 编写 测试 用 例 上 ，， 
如 末 能 把 这 些 交 给 一 个 专用 的 框架 ， 让 它 在 你 专注 于 业务 逻辑 测试 的 时 候 把 那些 脏 活 囚 活 部 瞧 你 做 
三 旦 不 是 更 好 。 我 们 去 看 一 下 如 何 用 nodeuniti 上 事情 变 得 更 容易 ， 它 是 一 个 第 三 方 的 单元 测试 慌 染 。 




















10.1.2 Nodeunit 


使 用 单元 测试 框架 可 以 人 简化 单元 测试 。 这 些 框 架 通 常会 追踪 运行 了 多 少 个 测试 , 运行 多 个 测 
试 脚本 也 变 得 更 容易 。 

Node 社 区 创建 了 几 个 优秀 的 测试 框架 。 我 们 从 nodeunit ( https://github.conycaolan/nodeunit ) 
开始 看 起 ， 因 为 它 经 受 住 了 时 间 的 考验 ,得 到 了 偏爱 TDD 测 试 的 Node 开 发 人 员 的 青睐 。Nodeunit 
提供 了 一 个 命令 行 工 具 ， 可 以 运行 所 有 测试 ,并 让 你 知道 有 多 少 测试 通过 和 失败 了 ,不 用 你 自己 
针对 程序 实现 测试 工具 。 
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本 市 会 教 你 用 nodeunit 编 写 测 试 ， 它 既 可 以 测试 Node 程 序 代 人 码 ， 也 可 以 用 浏览 带 测试 客户 珊 
代码 。 你 还 会 学 到 nodeunit 如 何 应 对 退 躁 异步 运行 的 测试 所 市 来 的 挑战 。 


1. 安装 nodeunit 


用 下 面 的 命令 安装 nodeunit: 
$ npm install -~g nodeunit 
闭 完 后 你 就 得 到 了 一 个 新 命令 ，nodeunit。 你 可 以 给 这 个 命令 一 个 或 多 个 包 合 测试 的 目录 或 
文件 作为 参数 ， 它 会 运行 传人 目录 下 所 有 扩展 名 为 .js 的 脚本 。 
2. 用 nodeunit 测 试 Node 程 序 
为 了 把 nodeunit 深 加 到 你 的 项 目 中 ， 需 要 给 它们 创建 一 个 目录 ( 通 第 被 命名 为 Lest )。 每 个 
测试 脚本 都 应 该 用 测试 组 猴 exports 对 象 。 
这 里 有 一 个 nodeunit 服 务 帮 剖 测 试 文件 的 例子 : 
exports.testPony = function(test) f{ 
var isPony = true; 
test.ok(isPony, 'This is not a pony.')}; 


test.done().: 


} 

注意 前 面 这 个 测试 脚本 ， 它 没有 引入 任何 模块 。 在 测试 脚本 输出 的 每 个 函数 中 ，nodeunit 都 
在 传 给 它 的 对 象 中 自动 引入 了 assert 模 块 的 方法 。 在 前 面 那个 例子 中 ， 这 个 对 象 被 称 为 Lest。 

测试 脚本 输出 的 函数 一 旦 完成 ， 就 应 该 调用 done 方 法 。 如 果 没 有 调用 ， 这 个 测试 会 报告 一 
个 “Undonetests” 和 失败 。 通 过 检查 这 个 方法 是 否 调用 ，nodeunit 可 以 检查 所 有 已 开始 的 测试 是 否 
都 结束 了 。 

检查 测试 内 激发 的 所 有 上 断言 也 很 有 必要 。 为 什么 没有 激发 断言 ? 在 编写 单元 测试 时 , 测试 逻 
辑 本 身 就 有 很 多 bug 的 危险 总 是 存在 ， 从 而 导致 误 报 。 测 试 逻 辑 的 编写 方式 可 能 会 导致 某 些 断言 
未 被 计算 。 从 下 面 的 例子 来 看 ， 即 便 有 个 断言 没有 执行 ，test.done () 也 会 激发 并 给 出 成 功 报 告 : 


exports.testPony = function(test) { 
1if (false) 1{ 
test.ok(false, 'This should not have passed.');: 
} 
test.ok(true, 'This should have passed.');: 
test,.donel(),; 


} 
如 条 你 想 防止 这 种 情况 出 现 ， 可 以 手动 实现 一 个 断言 计数 硕 ， 比 如 下 面 代码 中 的 这 个 。 


代码 清单 10-8 手动 计数 断言 
exports.testPony = function(test) { 
var count = 0; < 一 断言 计数 
if (false) { 
test.ok(false, 'This should not have passed.'); 





























Count++; < 一 增加 断言 计数 
} 
test.ok (true, 'This should have passed..'),; 
Count++; < 一 增加 断言 计数 
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test.equal (count, 2, 'Not all assertions triggered.'); < 一 测试 断言 计数 
test.done(); 
l 


这 很 尝 琐 。nodeunit 提 供 了 一 个 更 好 的 办 法 ，test.expect。 你 可 以 用 这 个 方法 指定 每 个 测 
试 应 该 包含 的 断言 数量 。 这 样 不 必要 代码 的 行 数 就 更 少 了 了: 
exports.testPpony = function(test) { 
test,expect (2).; 


if (false) f 
test.ok(false, 'This should not have passed.').; 
} 
test.ok (true, 'This should have passed.');: 
test,donet{).; 
} 


除了 测试 Node 模 块 ，nodeunit 还 可 以 测试 客户 端 JavaScript， 用 一 个 测试 工具 就 可 以 测试 你 的 
Web 程 序 。 你 可 以 在 nodeunit 的 在 线 文档 ( https://github.com/caolan/nodeunit ) 上 看 到 那些 内 容 ， 
此 外 还 有 更 高 级 的 技术 。 

你 已 经 知道 如 何 使 用 TDD 口 味 的 单元 测试 框 亲 了， 接 下 来 我 们 去 看 一 下 如 何 纳 入 一 个 BDD 
风格 的 单元 测试 。 

















10.1.3 Mocha 


在 本 章 介 绍 的 测试 框架 中 , Mocha 是 最 新 的 , 并 且 它 还 是 一 个 容易 掌握 的 的 框架 。 尽管 Mocha 
是 BDD 风 格 的 , 但 你 也 可 以 把 它 用 在 TDD 风 格 的 测试 中 。Mocha 的 功能 多 种 多 样 ， 包 括 全 局 变量 
泄漏 检测 ， 此 外 ， 跟 nodeunit 一 样 ， Mocha 也 文 持 客户 端 测试 。 





全 局 变量 泄漏 检测 
你 应 该 不 会 需要 在 整个 程序 中 都 可 读 的 全 局 变量 , 并 且 按 照 编程 的 最 住 实践 , 你 最 好 尽量 
少 用 。 但 在 JavaScript 中 ， 不 经 意 间 就 能 创建 一 个 全 局 变量 ， 只 要 在 声明 变量 时 忘记 写 关 键 字 
var， 这 个 变量 就 是 全 局 变量 了 。Mocha 可 以 检测 出 这 种 无 意 间 出 现 的 全 局 变量 汇 漏 ， 如 果 你 
创建 了 全 局 变量 ， 它 会 在 测试 期 间 抛 出 错误 。 





如 果 你 想 禁 用 全 局 汇源 检测 ， 可 以 带 着 --ignored-leaks 选 项 运行 mocha 命 令 。 此 外 ， 
如 果 你 想 指 明 要 用 的 几 个 全 局 变量 ， 可 以 把 它们 放 在 --globals 选 项 后 面 ， 用 如 号 分 开 。 


Mocha 测 试 默认 使 用 BDD 风 格 的 函数 定义 和 设置 ， 这 些 聊 数 包括 describe、it、before、 
after 、beforeEach 和 afterEach。 另 外 你 也 可 以 用 Mocha 的 TDD 接 口 ， 用 suite 人 代替 了 
describe, tes tt 代替 it ， setup 代 蔡 before ， teatrdown 人 代替 after。 不 过 在 我 们 的 例子 中 用 
的 还 是 默认 的 BDD 接 口 。 

1. 用 Mocha 测 试 Node 程 序 

让 我 们 继续 深入 ， 创 建 一 个 名 为 memdb 的 小 项 目 ， 一 个 小 型 的 内 存 数据 库 ， 并 用 Mocha 测 试 
它 。 首 先 要 为 这 个 项 目 创建 目录 和 文件 : 
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$s mkdir -p memdb/test 
$ cd memdb 

$s touch jindex.js 

$s touch test/memdb.js 





测试 会 放 在 test 目 录 下 ， 但 在 你 编写 测试 前 ， 知 要 先 安 沪 Mocha: 
$s npm install -g mocha 


Mocha 默 认 使 用 的 BDD 接 口 看 起 来 如 下 面 的 代码 清单 所 示 。 
代码 清单 10-9 Mocha 测 试 的 基本 结构 


Var memdb = require!{'..'),; 
describe('memdb', function({()t 
describe('.savel(doc})', function(})t 
it('should save the document', functiont{(})t 


i 
}); 
}); 


Mocha 还 支持 TDD 和 qunit, 并 输出 了 风格 接口 , 在 项 目的 网 站 上 有 详细 介绍 ( http://visionmedia. 
github.com/mocha )， 但 为 了 阐明 不 同 接口 的 概念 ， 下 面 是 TDD 风 格 的 接口 : 





module.exports = { 
'memdb': 1 
'.Save(doc)': { 
'should save the document': function{}t 


} 
} 
} 
} 


这 两 个 接口 的 功能 都 是 一 样 的 , 但 现在 我 们 还 是 用 BDD 接 口 , 并 用 它 编写 第 一 个 测试 , 代码 
放 在 test/memdb.js 中 ， 如 下 所 示 。 这 个 测试 用 Node 的 assert 模 块 执行 断言 。 


代码 清单 10-10 ”描述 memdb.save 功 能 


var memdb = require('..'); 


var assert = require('assert').; ed 
describe('memdb', function()t 功能 描述 .save() 
describe('.save(doc)', function()t 方法 的 功能 
it('should save the document', function()t 
Var pet = { name: 'Tobi' }; | 描述 期 望 值 
memdb.save (pet).,， 
Var ret = memdb.first({ name: 'Tobi' }); 
assert(ret == pet).; 
}) | 确保 找到 了 pet 


1 
上 


只 要 执行 nocha 就 可 以 运行 这 些 测 试 。Mocha 会 执行 .ltest 目 录 下 的 JavaScript 文 件 。 因 为 你 还 
没 实现 .save () 方 法 ， 所 以 唯一 的 测试 失败 了 ， 如 图 10-2 所 示 。 
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wavded@dev: ~/Projects/memdb x 





wavded@dev ~/Projects/memdb» mocha 


XxX 1 of 1 test failed: 


1) memdb .save(doc) should save the document: 
TypeError: Object #<O0bject> has no method “save 
at Context.<anonymous> (/home/wavded/Projects/memdb/test/memdb.]js:8:13) 
at Test.Runnable.run (/usr/local/lib/node_modules/mocha/lib/runnable. js:184:32) 
at Runner.runTest (/usr/local/lib/node_modules/mocha/lib/runner.]js:300:10) 
at Runner.runTests.next (/usr/local/lib/node_modules/mocha/lib/runner.]js:346:12) 
at next (/usr/local/lib/node_modules/mocha/lib/runner.]js:228:14) 
at Runner.hooks (/usr/local/lib/node_modules/mocha/lib/runner.js:237:7) 
at next (/usr/local/lib/node_modules/mocha/lib/runner.]js:185:23) 
at Runner.hook (/usr/local/lib/node_modules/mocha/lib/runner.]js:205:5) 
at process.startup.processNextTick.process._tickCallback (node.js:244:9) 








Iwavded@dev ~/Projects/memdb» _ 


图 10-2” ”Mocha 的 失败 测试 
把 下 面 的 代码 放 到 index.js 中 。 让 测试 通过 | 
代码 清单 10-11 添加 保存 功能 


var db = [|]:; 








exports.save = function(doc)t 将 文档 添加 到 
dG, push (doc}: 数据 库 数 组 中 
2 
exborte. Eee = Tunction(oB)y 1 选择 跟 obj 的 所 有 属 
returii db.Filter(funetion(tdoo}t 性 相 匹 配 的 文档 
for (var key in obj) { 
if (doc[key] != obj[key]) { 不 匹配 ， 返 回 Ealse， 
return false; 不 选择 这 个 文档 
return 七 YUe ; 选择 这 个 文档 
1 Bn 只 要 第 一 
}; 文档 或 null 


用 Mocha 再 次 运行 测试 ， 如 图 10-3 所 示 ， 成 功 了 。 





wavded@dev: ~/Projects/memdb xX 


wavded@dev ~/Projects/memdb» mocha 


”1 test complete (2ms) 








wavded@dev ~/Projects/memdb» _ 





图 10-3 ”Mocha 的 成 功 测试 
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2. 用 Mocha 挂 钧 定义 设置 和 清理 逻辑 

这 个 测试 用 例假 定 memgb .first() 可 以 正常 工作 ， 所 以 你 也 要 给 它 添 加 几 个 测试 用 例 ， 用 
it() 孙 数 定义 对 它 的 预期 。 修改 后 的 test 文 件 , 代码 清单 10-12, 包含 了 一 个 新 概念 一 一 Mocha 挂 钩 。 
比如 说 ，BDD 风 格 的 接口 有 beforeEach() 、afterEach()、before() 和 after()， 它 们 接受 
回调 ， 你 可 以 在 aescribe() 定 义 的 测试 用 例 、 测 试 集 之 前 和 之 后 定义 设置 和 清理 逻辑 。 


代码 清单 10-12 ”添加 beforeEach 挂 钓 





var memdb = require('..'),; 
Var assert = require('assert').; 
descripet "emdb',. funictiont})1 在 每 个 测试 用 例 之 前 
beforeEach (function()t{ | 都 要 清理 数据 库 ， 保 
memdb. clear (); 持 测试 的 无 状态 性 
}) 
describe('.save(doc)', function()t{ 
it('should save the document', function()t 
var pet = { name: 'Tobi' }; 
memdb.save (pet}).: 
var ret = memdb.first{{ name: 'Tobi' }}); 
Aassert{ret == pet);: 


}) 
. 
对 .first() 的 第 一 


describe('.first(obj)', function()t 个 期 户 
it('should return the first matching Qoc'，ftunction(){ Le 


Var tobi = { name: 'Tobi' }:; 
Var Joki = { name: 'Loki' }; 


_ | 保存 两 个 文档 


memdb.save (tobi).; 
memdb.save (loki).; 


Var ret = memdb.first({ name: 'Tobi' }); 

assert (ret == tobi); | 确保 每 个 都 可 以 
正确 返回 

Var ret = memdb.first({ name: 'Loki' }); 

assert (ret == loki); 


}) 


it('should return null when no doc matches', function()tft 对 .first() 的 第 二 
Var ret = memdb.first({ name: 'Manny' }); 个 期 户 
7 二 


assert{(ret == null).， 
jy 
}) 
a 


理想 情况 下 , 测试 用 例 不 会 共 圣 任何 状态 。 要 让 memdb 满 足 这 一 要 求 ， 只 需要 在 index.js 中 实 
现 .clear() 方 法 移 除 所 有 文档 就 行 了 。 
exports.clear = function()})t 


db = []; 
不 


再 次 运行 Mocha， 你 应 该 看 到 三 个 测试 已 经 通过 了 。 








图 灵 社区 会 员 quqingtao 专 享 尊重 版 权 


10.1 单元 测试 031 


3. 测试 异步 逻辑 

我 们 还 没 在 Mocha 中 做 过 异步 逻辑 的 测试 。 为 了 演示 如 何 做 这 样 的 测试 ， 我 们 要 对 之 前 在 
index.js 中 定义 的 一 个 函数 做 个 小 改动 。 把 save 函 数 变 成 下 面 这 样 ， 提 供 一 个 可 选 的 回调 ， 会 在 
短暂 的 延 色 之 后 执行 (用 来 模拟 某 种 异步 操作 ): 

exports.save = functionldoc, cb}t 

db.push (doc).; 
if (cb) { 
setTimeout (function() { 
ee 
}, 1000}); 
} 

}; 

只 要 给 定义 测试 逻辑 的 函数 添加 一 个 参数 ， 就 可 以 把 Mocha 测 试用 例 定义 为 异步 的 。 这 个 参 
数 通 常 被 命名 为 done。 从 下 面 的 代码 中 可 以 看 到 如 何 修改 最 初 的 .save() 测 试 让 它 可 以 测试 异 
步 代码 。 
代码 清单 10-13 ”测试 异步 逻辑 

describe('.save(doc)', function()t 
it('should save the document', function(done)t 
Var pet = { name: 'Tobi' }; 
memdb.save(pet, function()t < 一 保存 文档 
人 Var ret = memdb.first({ name: 'Tobi' }); 
用 第 一 个 文 assert (ret == pet); 盯 言 文档 正 
档 调 用 回调 done (); | 告诉 Mocha 你 | 确保 存 了 





es 已 经 完成 这 个 
})s 测试 用 例 了 
}); 


这 个 规则 适用 于 所 有 挂 钓 ,比如 清理 数据 库 的 beforeEach() 挂 钓 可 以 增加 一 个 回调 , Mocha 
会 等 看 它 的 调用 ， 然 后 才 继 续 。 如 果 调 用 aone () 时 它 的 的 第 一 个 参数 是 个 错误 ，Mocha 会 报告 
这 个 错误 并 将 这 个 挂钩 或 测试 用 例 标 记 为 失败 : 

beforeEach (function (done})t 


memdb.clear (done}).， 


}) 
要 了 解 与 Mocha 有 关 的 更 多 内 容 ， 请 参见 完整 的 在 线 文档 : (http:/visionmedia.github.comy 
mocha )。Mocha 也 可 以 像 nodeunit 那 样 用 于 客户 端 JavaScript。 











Mocha 的 非 并 行 测试 
Mocha 一 个 接 一 个 地 执行 测试 ， 而 不 是 并 行 执行 ， 这 样 会 使 得 测试 包 执 行 得 更 慢 ， 但 编写 
起 来 更 容 荔 。 不 过 Mocha 不 会 让 任何 测试 运行 的 时 间 过 长 ， 它 默认 只 让 测试 运行 2000 之 秒 ， 超 
过 这 个 时 长 的 测试 就 会 失败 。 如 果 你 有 运行 时 间 更 长 的 测试 ， 可 以 带 着 --timeout 选 项 运行 
Mocha， 绘 它 指 定 一 个 更 大 的 数值 。 
对 于 大 多 数 测试 而 言 ， 串 行 运行 就 很 好 。 如 果 你 觉得 这 有 问题 ,还 有 其 他 可 以 并 行 执行 测 
试 的 框架 ， 比 如 Vows， 我 们 把 它 放 在 下 一 节 讨 论 。 
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10.1.4 Vows 


在 Vows 下 写 的 测试 可 以 比 其 他 很 多 单元 测试 框架 下 写 出 来 的 单元 测试 结构 化 更 强 ， 这 样 的 
测试 更 容易 理解 ， 更 容易 维护 。 

Vows 用 它 自己 的 BDD 术 语 定义 测试 结构 。 在 Vows 的 领域 中 ， 一 个 测试 套件 中 包含 一 或 多 个 
批 次 。 你 可 以 把 批 次 当 作 一 组 相互 关联 的 情境 , 或 者 你 想 要 测试 的 概念 关注 域 。 批 次 和 情境 是 并 
行 运 行 的 。 情 境 中 可 能 包含 一 些 东 西 : 一 个 主题 ,一 或 多 个 誓约 ， 以 及 /或 者 一 或 多 个 相关 情境 
( 内 部 情境 也 是 并 行 运行 的 )。 主 题 是 跟 情 境 相 关 的 测试 逻辑 。 拆 约 是 对 主题 结果 的 测试 。Vows 
对 测试 的 结构 化 设 定 如 图 10-4 所 示 。 


























一 或 多 一 或 多 
EE 1 
图 10-4 ”Vows 可 以 用 批 次 、 情 境 、 主 题 和 站 约 把 测试 组 织 在 一 个 套件 内 


Vows， 跟 nodeunit 和 Mocha 一 样 ， 是 专门 针对 自动 化 程序 测试 的 。 差 异 主要 体现 在 口味 和 并 
行 性 上 , Vows 测 试 还 有 特定 的 结构 和 术语 。 本 市 会 给 出 一 个 程序 测试 示例 , 并 介绍 如 何 使 用 Vows 
同时 运行 多 个 测试 。 

一 般 来 说 ， 你 应 该 把 Vows 安 装 到 全 局 环境 中 ， 以 便 可 以 随处 访问 vows 的 命令 行 测试 运行 工 
具 。 输 入 下 面 的 命令 安装 Vows: 

$s npm install -9 可 vows 

用 Vows 测 试 程序 结构 

在 Vows 中 ， 你 既 可 以 运行 包含 测试 逻辑 的 脚本 来 触发 测试 ， 也 可 以 用 vows 的 命令 行 测试 运 
行 锅 。 下 面 这 个 例子 是 个 独立 的 测试 脚本 〈 可 以 像 其 他 Node 脚 本 那样 运行 )， 用 了 待 办 事项 程序 
核心 逻 测 试 的 其 中 一 个 。 

代码 清单 10-14 创 建 了 一 个 批 次 。 在 这 个 批 次 内 定义 了 一 个 情境 。 在 情境 内 定义 了 一 个 主题 
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和 一 个 址 约 。 注音 它 在 主题 中 如 何 使 用 回调 处 理 异步 逻辑 。 如 果 主 题 不 是 异步 的 ,可 以 返回 一 个 
值 ， 不 用 通过 回调 发 送 。 


代码 清单 10-14 ”用 Vows 测 试 待 办 事项 程序 


Var VOWS = require('vows') 





Var assert = require('assert') 
Var Todo = require('./todo'); 


vows .describe('Todo') .addpatch(t < 一 批 次 
'when adding an item': { < 一 情境 
topic: function () { < 一 主题 
Var todo = new Todo(); 
todo.add('Feed my cat'); 
return todo; 
}, 
'it should exist in my todos': function(er, todo) { < 一 哲 约 
assert,.equal (todo.getCount(), 1): 
} 
} 


js 

如 果 你 想 把 前 面 那 段 代码 放 到 测试 文件 夹 下 ， 放 在 可 以 由 Vows 测 试 运行 器 运 行 的 地 方 ， 你 
最 好 把 最 后 一 行 改 成 下 面 这 样 : 

RE 

要 运行 test 目 录 下 的 所 有 测试 ， 请 输入 下 面 这 条 命令 : 

$s VOwS test/* 


要 了 解 与 Yows 有 关 的 更 多 内 容 , 请 查阅 该 项 目的 在 线 文 档 ( http://Vowsjs.org/ ), 如 图 10-5 所 示 。 





AMAQ Vows « Asynchronous BDD for Node 


= 
Ra< je) CL htp://vowsjs.org/ Bn Res cooute Q (全) 


| ] Vows « Asynchronous BDD for Node 




















Write some vows, execute them: 
SS i py gy a ey py py 


Ky 
EE 
A non-promise return value 
converted to a pror 


Asynchronous behaviour | should be 
driven development for Node. A 









There are two reasons why we might want 
asynchronous testing. The first, and obvious reason is 
that node.js is asynchronous, and therefore our tests 】 pp en 

should be. The second reason is to make tests which ;A nested context with no top 

target I/O run much faster, by running them a 
concurrently. | vOK»7 honored e 1 pending (0.112s) 


图 10-5 ”Vows 将 完整 的 BDD 测 试 能 力 跟 宏和 流程 控制 之 类 的 特性 结合 到 一 起 








Vows 提 供 了 全 面 的 测试 方案 ， 但 你 可 能 不 喜欢 它 规定 的 那 种 使 用 批 次 、 情 境 、 主 题 和 壮 约 
的 测试 结构 。 或 者 你 可 能 豆 欢 一 个 有 苋 争 力 的 测试 框 织 的 特性 ， 或 者 跟 其 他 框 以 类 似 的 方案 , 没 
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必要 学 习 Vows。 如 果 你 觉得 这 上 听 起 来 像 你 ，should.js 可 能 值得 一 试 。should.js 不 仅 是 另 一 个 测试 
框架 ， 它 更 像 是 以 BDD 口 味 使 用 assert 模 块 的 框架 。 


10.1.5 should.js 


should.js 是 一 个 断言 库 ， 让 你 可 以 用 类 似 于 BDD 的 风格 表示 断言 ， 从 而 使 测试 更 容易 看 懂 。 
它 的 设计 初衷 是 跟 其 他 测试 框架 捆绑 使 用 , 让 你 可 以 继续 使 用 自己 喜欢 的 框架 。 本 节 会 介绍 如 何 
用 should.js 编 与 断言， 我 们 用 的 例子 是 给 一 个 定制 的 模块 编写 测试 。 

should.js 很 容易 跟 其 他 框架 配合 使 用 ， 因 为 它 有 一 个 object .prototype 属 性 : shoula。 
你 可 以 用 它 编 写 表 达能 力 很 强 的 时 言 、 比如 user .role.should.egqual ("admin"),, 或 者 
users .Should. LIneclude("ricek")s 

用 should.js 测 试 模块 功能 

假定 你 正在 编写 一 个 Node 命 令 行 的 小 费 计算 项 ,在 你 跟 朋 友 采 用 AA 制 付费 时 ， 想 用 它 算出 
个 人 该 付 多 少 。 你 希望 你 的 非 程 序 员 朋 友 也 能 看 懂 你 给 计算 逻辑 写 的 测试 ， 以 免 他 们 怀疑 你 要 诈 。 

输入 下 面 的 命令 设置 你 的 小 费 计 算 瘟 ， 它 会 给 程序 设置 一 个 文件 来 ， 并 创建 用 于 测试 的 
should.js 文 件 : 


$s mkdir -p tips/test 
$ Cd tips 
$ touch jndex.js 











$s touch test/tips.js 

你 可 以 运行 下 面 的 命令 安装 should.js: 

s npm install should 

然后 编辑 index.js 文 件 , 放 和 人 包含 程序 核心 功能 定义 的 逻辑 。 有 具体 来 说 , 小 费 计 算 希 包含 四 个 
辅助 函数 : 

口 adqdqPercentageToEach 按 给 定 的 百分比 增加 数组 中 的 所 有 数值 ; 

D sum ”计算 数组 中 所 有 数值 的 和 值 ; 

percentFormat 对 要 显示 的 百分比 进行 格式 化 ; 

口 dollarFormat 对 要 显示 的 金额 进行 格式 化 。 

下 面 代码 清单 中 的 代码 实现 了 这 些 逻 辑 ， 把 它们 放 到 index.js 中 : 


代码 清单 10-15 ”分账 时 计算 小 费 的 人 逻辑 


exports.addPercentageToEach = function(prices, percentage) { | 

















向 数组 元 素 中 
添加 百分比 


return prices.map (function(total) { 
total = parseFloat (total).; 
return total + (total * percentage).; 
Ly 
) en 
exports.sum = function(prices) { 的 和 什 
return prices.reduce(function(currentSum, currentValue) { 
return parseFloat (currentSum) + parseFloat (currentValue); 
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} 对 要 显示 的 百分比 
进行 格式 化 
exports.percentFormat = function(percentage) { 
return parseFloat (percentage) * 100 + '%',，; 
} | 对 要 显示 的 金额 
exports.dollarFormat = function(number) { 进行 属 式 化 


return 'S$' + parseFloat (number) .toFixed (2).;， 


} 
按照 代码 清单 10-16 编 辑 testytips.js 中 的 脚本 。 这 段 代 码 加 载 小 费 逻 辑 模块 ， 定 义 了 税率 和 人 小费 
百分比 ,以 及 账单 中 的 收费 项 目 以 便 进行 测试 , 测试 每 个 数组 元 素 的 百分比 增加 , 测试 账单 总 额 。 


代码 清单 10-16 ”AA 和 制 时 计算 小 费 的 逻辑 








二 < 使 用 小 费 罗 辑 模块 
var Should = redqulire(' shouldq') ; 

Var tax = 0.12; < 一 定义 税率 和 小 费 比 率 

var tip = 0.15; 

Var Drices Ss [10, 20]; < 一 定义 要 测试 的 账单 项 


Var pricesWithTipAndTax = tips.addPercentageToEach (prices, tip + tax).; 


pricesWithTipAndTax[0] .should.equal (12.7); < 一 定义 税 和 小 费 的 增加 
pricesWithTipAndTax[1] .should.equal (25.4); 


var totalAmount = tips.sum(pricesWithTipAndTax) .toFixed(2).; 
totalAmount, should.eouaLl (38,.10")s < 一 测试 账单 总 额 


var totalAmountAsCurrency = tips.dollarFormat (totalAmount),; 
totalAmountAsCurrency.should.egqgual('$38.10'),， 


var tipASsSPercent = tips.pPercentFormat (tipn): 
tipAsPercent.should.egqgual{'1Ss%®S').; 


用 下 面 的 命令 运行 这 段 脚 本 。 如 果 一 切 都 好 ， 这 个 脚本 应 该 不 会 输出 什么 ,因为 断言 没有 抛 
出 错误 ， 并 且 你 的 朋友 又 再 次 加 深 了 对 你 的 信任 : 

$s node test/tips.js 

should.js 文 持 的 断言 有 很 多 种 一 从 使 用 正则 表达 式 的 到 检查 对 象 属性 的 全 都 有 
程序 生成 的 数据 和 对 象 进行 全 面 的 测试 。 这 个 项 目的 GitHub 页 面 (http://github.com/visionmedia/ 
should.js ) 中 有 完整 的 should.js 功 能 文档 。 

看 完 为 单元 测试 设计 的 工具 ， 我 们 要 继续 前 进 ， 去 看 另外 一 种 风格 完全 不 同 的 测试 : 验收 
测试 。 


10.2 验收 测试 


验收 测试 也 被 称 为 功能 测试 , 它 测试 程序 的 输出 而 不 是 逻辑 。 在 为 项 目 创建 了 一 套 单 元 测试 
后 ， 验 收 测试 可 以 再 提供 一 层 防 护 ， 找 出 可 能 被 单元 测试 涯 挥 的 bug。 
从 概念 上 来 看 , 验收 测试 跟 照 着 验收 检查 单 进行 测 试 的 最 终 用 户 差 不 多 。 但 日 动 化 的 验收 测 
试 更 快 ， 并且 在 执行 测试 的 过 程 中 不 需要 人 力 成 本 。 
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验收 测试 还 要 应 对 客户 病 JavaScript 行 为 产生 的 复杂 性 。 如 果 客 户 端 JavaScript 中 隐藏 着 一 个 
严重 的 问题 ， 服 务 硕 端 单元 测试 捕捉 不 到 它 ， 但 全 面 彻底 的 验收 测试 可 以 。 比 如 说 ， 程 序 可 能 
客户 端 JavaScript 做 表单 校 验 。 验收 测试 会 确保 你 的 校 验 逻辑 管用 , 拒绝 和 接受 输入 正确 。 或 者 再 
举 一 个 例子 , 你 可 能 有 一 个 Ajax 丝 动 的 管理 功能 比如 在 网 站 的 首页 上 浏览 内 容 选 择 特定 内 容 
的 能 力 应 该 只 有 已 认证 用 户 才 能 访问 。 为 了 处 理 这 个 问题 ， 你 可 以 写 个 测试 ， 确 保 用 户 登 录 
后 的 Ajax 请 求 能 产生 预期 结果 ， 然 后 再 写 个 测试 确保 那些 没有 认证 的 用 户 不 能 访问 这 些 数据 。 

本 贡 会 介绍 两 个 验收 测试 框架 : Tobi 和 Soda。Soda 的 优 热 在 于 它 能 用 真正 的 浏览 各 做 验收 测 
试 ， 而 Tobi， 我 们 先 介 绍 这 个 ， 学 习 起 来 更 容易 ， 启 动 和 在 其 上 运行 也 更 人 简单。 






































10.2.1 Tobi 


Tobi (https:/github.com/LearnBoost/tobi ) 是 一 个 很 容易 使 用 的 验收 测试 框架 ， 它 能 模拟 浏览 
大 ， 并 提供 访问 should.js 旱 言 的 能 力 。 这 个 框架 用 两 个 第 三 方 模块 ，jsdom 和 htmlparser， 来 模拟 
Web 浏 览 术 ， 可 以 访问 虚拟 DOM。 

们 助 Tobi， 你 几乎 可 以 这 不 痛 冰 地 编写 测试 登录 到 你 的 Web 程 序 中 ， 如 果 需 要 ， 还 可 以 模拟 
用 户 癌 程序 发 送 Web 请 求 。 如 果 Tobi 返 回 了 意 想 不 到 的 结果 ， 它 会 警告 你 ， 把 问题 指出 来 。 

为 Tobij 必 须 模拟 用 户 的 活动 , 还 要 检查 Web 请 求 的 结果 ， 所 以 它 必须 经 党 处 理 或 检查 DOM 
元 系 。 在 客户 问 JavaScript 开 发 界 ， 当 Web 开 发 人 员 要 跟 DOM 交 互 时 ， 他 们 经 和 常会 使 用 jQuery 库 
(http:/jquery.com )。 开 发 人 员 也 可 以 在 服务 需 端 使 用 jQuery， 而 Tobi 对 jQuery 的 使 用 让 你 几乎 不 
用 学 习 就 可 以 用 它 创建 测试 。 

我 们 会 在 本 中 讲解 如 何 使 用 Tobi 路 越 网 络 测试 任何 正在 运行 的 web 程序， 包括 非 Node 程 
序 。 我 们 还 会 演示 如 何 测试 用 Express 创 建 的 Web 程 序 , 即便 这 个 基于 Express 的 Web 程 序 没 在 运行 。 

用 Tobi 测 试 Web 程 序 

如 果 你 想 用 Tobi 创 建 测试 ， 首 先 要 为 它们 创建 一 个 目录 (或 用 一 个 已 有 的 程序 目录 )， 然 后 
在 命令 行 中 进入 这 个 日 录 ， 输 入 下 面 的 命令 安 疙 Tobi: 

a 

代码 清单 10-17 是 用 Tobi 测 试 Web 程 序 功能 的 例子 一 一 这 是 我 们 在 第 $ 章 测试 过 的 竺 办 事项 程 
序 。 这 个 测试 试图 创建 一 个 竺 办事 项， 然后 在 啊 应 页 面 上 寻找 它 。 如 果 你 用 Node 运 行 这 段 脚 本 ， 
并 且 没 有 异常 抛 出 ， 那 么 这 个 测试 就 是 通过 了 了。 

这 上 段 脚本 创建 了 一 个 模拟 浏览 弱 ， 用 来 向 带 有 输入 表单 的 主页 发 送 HTTP GET 请 求 ， 填 入 表 
单 中 的 输入 域 ， 并 提交 表单 。 然 后 检查 表格 单元 中 的 内 容 有 没有 “Floss the Cat”。 如 有 果 有 ， 则 测 
试 通过 。 


代码 清单 10-17 通过 HTTP 测 斌 Web 程序 
































var tobi = require('tobi'); 
Var Drowser = tobl oreateBrowser(3000, "127.0.0,.1'1)s < 一 创建 浏览 器 
browser.get('/', function(res, $)t < 取得 待 办 事项 表单 
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S('form') 
Fill({ esce otiony "Ploss: the watr }) < 一 填写 表单 
.submit(function(res, S$) f{ < 一 提交 数据 
s('td:nth-child(3}') .text{() .should.egual ('Floss the cat'}); 
1 
}); 


其 至 不 用 运行 就 能 测试 前 面 那 个 程序 。 下 面 的 Tobi 测 试 就 是 这 样 做 的 : 
var tobi = require('tobi'); 


var app = require('./app'}).; 
Var browser = tobi.createBrowser (app):; 











browser.get{('/about', function(res, S$}1t 
res.should.have.status (200); 
$s{('div'}) .should.have.one{({'hl', 'About'); 
app.closel().; 
了 了 
2 人 


Tobi 中 没有 测试 运行 器 , 但 你 可 以 把 它 跟 Mocha 或 nodeunit 之 类 的 单元 测试 框架 结合 在 一 起 使 用 。 








10.2.2 Soda 


Soda ( https://github.com/LearnBoost/sod ) 采用 了 一 种 不 同 的 方式 做 验收 测试 。 其 他 Node 验 收 
测试 框架 都 是 模拟 浏览 锅 , 而 Soda 是 远程 控制 芮 实 的 浏览 锅 。S$oda, 如 图 10-6 所 示 , 通过 给 Selenium 
服务 硕 〈 也 被 称 为 Selenium RC )， 或 者 Sauce Labs 的 按 需 测试 服务 ， 发 送 指令 进行 测试 。 


Machine boundary (optional) 
Selenium RC or 
Sauce Labs 











Internet Explorer 





图 10-6 ”Soda 是 一 个 验收 测试 框架 ， 可 以 远程 控制 真实 的 浏览 器 。 不 管 是 用 Selenium 
RC 还 是 Sauce Labs 服 务 ，Soda 都 会 提供 一 个 API， 让 Node 进 行 直接 测试 ， 可 以 


顾及 到 不 同 浏览 器 实现 的 实际 情况 
Selenium 服 务 需 会 在 它 所 在 的 机 需 上 打开 浏览 锅 , 而 Sauce 云 会 在 互联 网 的 某 合 服务 硕 上 打开 
一 个 虚拟 的 浏览 套 。 
跟 浏 览 器 通话 的 是 Selenium 上 服务 器 和 Sauce Labs， 而 不 是 Soda， 但 它们 会 把 所 有 请 求 信息 传 
回 给 Soda。 如 果 你 要 做 一 些 并 行 的 ， 并 且 不 消耗 你 目 己 硬件 的 测试 ， 可 以 考虑 用 Sauce Labs。 
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本 节 会 讲解 如 何 安装 Soda 和 Selenium 服 务 闫 ， 如 何 用 Soda 和 Selenium 测 试 ， 以 及 如 何 用 Soda 
和 Sauce Labs 测 试 。 

1. 安装 Soda 和 Selenium 服 务 器 

用 Soda 测 试 需要 安 竣 sodanpm 包 和 Selenium 服 务 融 〈 如 有 末 你 不 用 Sauce Labs 的 话 )。 输 入 下 面 
的 命令 安装 Soda: 

$ npm install soda 

Selenium 服 务 融 需要 有 Java 才 能 运行 。 如 果 你 还 没 闭 Java， 请 参考 Java 的 官方 下 载 页 面 , 按照 
对 你 操作 系统 的 指导 安装 (www.java.comy/en/download/ )。 

Selenium 服 务 妖 的 安装 相当 俐 单 下 接 。 你 要 做 的 只 是 从 Selenium 的 “下 载 ” 页 ( http://seleniumhq. 
org/download/ ) 下 载 最 新 的 .jar 文件 。 文 件 下 载 下 来 之 后 ,你 就 可 以 用 下 面 这 条 命令 运行 它 (文件 
名 中 可 能 有 不 同 的 版 本 号 ): 

Java -Jar selenium-server-standalone-2.6.0.1ar 

2. 用 Soda 和 Selenium 测 试 Web 程 序 

服务 右 运 行 起 来 后 ， 你 可 以 把 下 面 的 代码 放 到 一 个 脚本 中 为 运行 测试 做 好 设置 。 在 对 
createClient 的 调用 中 , host 和 port 指 明 了 连接 Selenium 服 务 磊 的 主机 和 站 口 。 它们 默认 应 
该 是 127.0.0.1 和 4444。czreateclient 中 的 uz1 指 定 了 要 在 浏览 硕 中 打开 的 根 URL， 而 browse 
指定 了 用 于 测试 的 浏览 器 : 

var soda = require('soda') 

var assert = require('dassert').; 























var browser = soda.createClient!{t 

host: '127.0.0.1',， 

Port: 4444, 

url: http://www.reddit.com', 

browser: ‘firefox,' 
J 
为 了 得 到 测试 脚本 正在 做 什么 的 反馈 ,你 可 能 想 要 引 人 下 面 这 段 代 码 。 这 段 代 人 码 输 出 
Selenium 尝 试 的 每 条 命令 : 

browser.on('command', functicon(cmd, args})t 
console,.,log(cmd, args.jJoin(', ')): 


713 

接 下 来 应 该 在 测试 脚本 中 的 是 测试 本 身 。 下 面 的 清单 中 是 一 个 测试 样 例 , 它 试 图 让 用 户 登 录 
到 Reddit 中 ， 如 采 结 打 页 面 中 没有 “logout ”字样 ， 则 测试 失败 。 像 clickandawait 这 样 的 命令 在 
Selenium 的 网 站 上 (http://release.seleniumhqg.org/selenium-core/1.0.1/reference.html ) 都 有 文档 说 明 。 


代码 清单 10-18 ”可 以 用 命令 控制 浏览 帮 动 作 的 Soda 测 试 











browser 
.Chain < 一 启用 方法 链 
:eslont) < 一 开始 Selenium 会 话 
OBm( S 打开 URL 
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.type('user', 'mcantelon') < 一 向 表单 域 中 输入 文本 
.type('passwd', 'mahsecret') 
.ClickAndWait('//button[@type="submit"]') < 一 点 击 按钮 并 等 待 
.assertTextPresent('logout') < 一 人 确保 这 段 文字 存在 
.testComplete!() < 一 完成 测试 

.end (function (err)t{ < 一 结束 Selenium 会 话 


if (err) throw err; 
console.log('Done!'); 


}); 
3. 用 Soda 和 SAUCE LABS 测 试 Web 程 序 
如 果 你 走 Sauce Labs 的 路 线 ， 则 要 在 Sauce Labs 网 站 (https://saucelabs.com ) 上 注册 ， 并 把 测 
试 脚 本 中 返回 browser 的 代码 换 成 下 面 这 样 的 。 


代码 清单 10-19 ”用 Soda 控 制 Sauce Labs 济 i 





Var browser = soda.createSauceClient(t{ 
‘url': 'http://www.reddit.com/', 
'username': 'yourusername', < 一 Sauce Labs 用 户 名 
'access-key': '!YyouraccesSskey ' ， <— Sauce Labs API key 
'os': 'Windows 2003', < 一 想 要 的 操作 系统 
"Drowser: firetox’, < 一 想 要 的 浏览 器 类 型 
browBer_ version': 3,.6", < 一 想 要 的 浏览 器 版 本 
'name': 'This is an example test ' ， 
'max-duration': 300 < 一 如 果 时 间 太 长 ， 让 测试 失败 
| 

这 些 就 是 这 种 强大 的 测试 方法 的 基础 知识 , 它 可 以 作为 单元 测试 的 补充 , 让 你 的 程序 对 不 经 


意 间 创建 出 来 的 bug 更 有 抵抗 力 。 
10.3 ”小结 


把 自动 化 测试 纳入 开发 过 程 可 以 极 大 降低 代码 中 出 现 bug 的 几率 ,你 在 做 开发 时 也 能 更 有 自信 。 

如 果 你 刚 接触 单元 测试 ，Mocha 和 nodeunit 是 非常 优秀 的 入 门框 架 : 简单 易学 义 灵 活 ， 如 果 
你 想 运行 BDD 风 格 的 断言 ， 它 们 还 能 跟 should.js 捆 绑 使 用 。 如 果 你 喜欢 BDD 风 格 ， 并 且 想 找 一 个 
能 组 织 测试 和 控制 流程 的 系统 ，Vows 可 能 也 是 个 不 错 的 选择 。 

在 验收 测试 领域 Tobi 是 非常 棱 的 起 点 。 设置 和 使 用 起 来 都 很 容易 ， 如 果 你 熟悉 jQuery 的 话 ， 
应 该 能 迅速 掌握 它 。 如 果 你 在 做 验收 测试 时 需要 考虑 不 同 浏览 絮 的 差异 ，Soda 值 得 一 试 , 但 用 它 
测试 会 比较 慢 ， 并 且 你 还 必须 学 习 Selenium API。 

你 已 经 知道 在 Node 中 如 何 做 自动 化 测试 了 , 接 下 来 我 们 要 深入 到 Node 的 Web 程 序 模板 中 , 介 
绍 一 些 可 以 提升 你 的 开发 效率 和 愉悦 感 的 模板 引擎 。 
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Web 程 友 模 板 





本 章 内 容 

口 如 何 用 模板 保持 程序 的 可 组 织 性 
口 用 Embedded JavaScript 创 建 模 板 
口 学 习 极 简 主 义 的 Hogan 模 板 

口 用 Jade 创 建 模 板 











在 第 8 和 第 9 莉 用 Express 框 架 创建 视图 时 , 我 们 已 经 介绍 过 一 些 模板 的 基础 知识 了 。 在 这 一 章 
里 ， 你 将 完全 沉浸 在 模板 之 中 , 学 习 如 何 使 用 三 个 流行 的 模板 引擎 ， 如 何 用 模板 把 显示 层 标 记 从 
逻辑 中 分 离 出 来 ， 保 持 Web 程 序 代 码 的 整洁 性 。 
如 采 你 对 模板 和 模型 -视图 -控制 项 (MYVC ) 模式 并 不 阴 生 ,可 以 十 接 进 入 11.2 太 ,从 那里 开 
台 学 习 我 们 要 在 本 草 中 详细 介绍 的 模板 引擎 ， 包 括 Embedded JavaScript、Hogan 和 Jade。 如 采 你 
对 模板 不 太 了 解 ， 请 继续 往 下 看 一 一 我 们 会 在 后 续 几 市 中 探索 它 的 概念 。 


11.1 用 模板 保持 代码 的 整洁 性 


在 Node 中 ， 你 可 以 像 其 他 所 有 Web 技 术 一 样 ， 用 模型 -视图 -控制 问 ( MVC ) 模式 开发 传统 
的 Web 程 序 。MVC 中 的 一 个 关键 概念 是 逻辑 、 数 据 和 展示 层 的 分 离 。 在 避 循 MVC 模 式 的 Web 程 
序 中 ,用 户 通 常会 从 服务 右 中 请 求 一 个 资源 ， 这 会 让 控制 器 从 模型 中 请 求 程序 数据 ,然后 把 数据 
传 给 视图 ， 再 由 视图 对 数据 做 格式 化 后 呈现 给 最 终 用 户 。MVC 模 式 中 的 视图 部 分 经 常 是 用 几 种 
模板 语言 中 的 一 种 实现 的 。 程 序 使 用 模板 时 ,视图 会 将 模型 返回 的 数据 传递 给 模板 引擎 ， 并 指定 
用 哪个 模板 文件 展示 这 些 数据 。 

图 11-1 展 示 了 模板 逻辑 如 何 融 入 一 个 MVC 程 序 的 整体 架构 中 。 

模板 文件 中 通常 包含 程序 值 的 占 位 符 , 以 及 HTML 、CSS, 有 时 还 会 有 一 些 客户 端 JavaScript， 
做 些 显 示 第 三 方 小 部 件 之 类 的 事情 ， 比 如 Facebook 的 点 赞 按钮 ， 或 者 触发 界面 行为 ， 比 如 隐藏 或 
显示 页 面 的 某 些 部 分 。 因 为 模板 文件 的 重点 是 展示 而 不 是 逻辑 , 所 以 前 端 开发 人 员 和 服务 需 端 开 
发 人 员 可 以 一 起 工作 ， 这 有 助 于 项 目 对 人 力 资 源 的 分 配 。 

本 节 会 分 别 在 有 和 没有 模板 的 两 种 情况 下 泻 染 HTML,， 让 你 看 到 两 者 之 间 的 差异 。 但 我 们 还 
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是 先 看 一 个 模板 的 实例 吧 。 








Web 程 序 


















1. 浏览 器 请 求 


3. 发 送 数 据 给 视图 





浏览 lbs 








4. 发 送 原始 数据 










7. 程 序 啊 应 











5. 从 硬盘 中 读 
取 模 板 文 件 


> 
模板 文件 


6. 接受 由 模板 
引擎 组 织 好 的 
HTML/CSS 








图 11-1 MVC 程 序 的 流程 以 及 它 跟 模板 层 的 交互 


模板 实战 


为 了 快速 演示 一 下 如 何 使 用 模板 ， 我 们 以 一 个 人 简单 的 博客 程序 为 例 ， 看 它 如 何 优雅 地 输出 
HTML。 每 篇 博客 文章 都 会 有 一 个 标题 、 发 布 日 期 以 及 主体 文本 。 博客 在 浏览 带 中 如 图 11-2 所 示 。 





HMQ Mozilla Firefox 


1 http://127.0.0.1:8000/ | 二 ~ 
It's my birthday! 
January 12, 2012 
I am getting old, but thankfully Im not in jail! 


Movies are pretty good 

January 2, 2012 

TVve been watching a lot of movies lately. Its relaxing， 
except when they have clowns in them. 








图 11-2 ”博客 程序 示例 在 浏览 锅 中 的 输出 


博客 文章 是 从 文本 文件 entriestxt 中 读 取 出 来 的 ， 格 式 如 下 所 示 。-- -表明 一 篇 文章 结束 ， 另 
一 篇 文章 开始 。 
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代码 清单 11-1 博客 文章 文本 文件 
title: It's my birthday! 


date: January 12, 2012 
I am getting old, but thankfully 工 f not in jaill! 


title: Movies are pretty good 


date: January 2, 2012 
I've been watching a lot of movies lately. 
except when they have clowns in them. 


blog.js 中 的 博客 程序 代码 从 引入 必要 的 醒 块 开始 ， 谈 入 博客 文章， 如 下 所 示 。 





It's relaxing, 





代码 清单 11-2 ”简单 的 博客 程序 的 博客 文章 文件 解析 逻辑 





var fs = require('fs'); 
Var http = require('http'); 读 取 和 解析 博客 
function getEntries() { 文章 文本 的 函数 
ti = ; 
a : 从 文件 中 读 取 博 客 
var entriesRaw = fs.readFileSync('./ So ea 
entries. Extr, wtterys 文革 的 数据 
entriesRaw = entriesRaw.split("-—-—-").; 解析 文本 ， 将 它们 
放 上 丰 复 秘 风 训 音 
entriesRaw.map (function(entryRaw) { 分 成 一 篇 篇 的 文章 
var entry = {}; 解析 文章 的 文本 ， 
Var lines = entryRaw.split("\n"); 将 它们 按 行 分 解 
lines.map(function(line) { 逐 行 解析 ， 提 取 
If (line.indexOf ('title: ') === 0) { 出 文章 的 属性 
entry.title = line.replace('title: ', ''); 
} 
else lf (line.indexof('date: ') === 0) { 
entry.date = line.replace('date: ', '').; 
} 
else 1{ 


entry.body = entry.body || ''; 
entry.body += l]ine; 


entries.push (entry).: 
本 


return entries; 


} 


Var entries = getEntries'(); 
console.log(entries).,; 


把 下 面 这 段 代 码 添加 到 博客 程序 中 , 它 定义 了 一 个 HTTP 服 务 禹 。 这 个 服务 右 收 到 HTTP 请 求 
， 会 返回 一 个 包含 所 有 博客 文章 的 页 面 。 这 个 页 面 是 用 函数 blogPage 定 义 的 ， 我 们 过 一 会 儿 


2 











tH Hh 
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var server = http.createServer (tuncttonreG，Lres) ({ 
var output = PbPlocPadelenmntrIeS) ， 


res.writeHead(200, {'Content-Type’'’: 'text/html'}); 
res.end(output).: 


hs 

server.listen(8000),， 

接 下 来 我 们 要 定义 plogPage 函 数 ， 用 它 把 博客 文章 泻 染 到 HTML 页 面 中 ， 以 便 发 送 给 用 户 
的 浏览 锅 。 我 们 会 竹 试 两 种 不 同 的 方式 : 

口 不 用 模板 演 染 HTML; 

口 用 模板 泻 染 HTML。 

我 们 先 来 看 一 下 不 用 模板 的 泻 染 。 

1. 不 用 模板 泻 染 HTML 

博客 程序 可 以 直接 输出 HIML， 但 在 程序 逻辑 中 引入 HIML 会 导致 混乱 。 在 下 面 的 代码 清单 
中 ，blogPage 函 数 前 明了 如 何 用 非 模 板 的 方式 显示 博客 文章 。 


代码 清单 11-3 ”模板 引擎 把 展示 细节 和 程序 逻辑 分 开 











function blogPage (entries) { 逻辑 中 穿插 了 太 

var output = '<html>' 多 的 HTML 
+ '<head>' 
+ '<style type="text/css">,' 
+ '.entry_ title { font-weight: bold; }' 
+ '.entry_date { font-style: italic; }' 
+ '.entry body { margin-bottom: lem; }' 
+ '</Style>'! 
+ '</head>'! 
+ '<body>'; 

entries.map(function(entry) 1{ 
OUtpPUt += '<diyv Class="entry titlje'">’' + entry,.title + "</div>\n' 


+ '<div class="entry date'">' + entry.date + "</div>\n" 
+ '<div class="entry body'">' + entry.body + "</div>\n"; 


Fl 
output += '</body></html>',， 


return output:; 


} 

注意 看 ， 这 些 跟 展示 相关 的 内 容 、CSS 定 义 和 HTML 给 程序 添 了 很 多 行 代 码 。 

2. 用 模板 泻 染 HTML 

用 模板 泻 染 HTML 可 以 把 HTML 从 程序 逻辑 中 挪 走 ， 大 幅 提 升 代码 的 整洁 性 。 

本 节 中 的 演示 程序 需要 在 你 的 程序 目录 中 安装 Embedded JavaScript ( EJS ) 模块 。 输 入 下 面 











npm install ejs 
下 面 的 代码 从 文件 中 加 载 了 一 个 模板 ， 然 后 定义 了 一 个 新 版 的 blogPage 函 数 ， 这 次 它 采 用 了 
EJS 模 板 引 擎 ， 我 们 会 在 11.2 方 中 介绍 这 个 模板 引擎 的 用 法 : 
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Var ejs = require('ejs'); 
var template = fs.readFileSync('./template/blog page.ejs', 'utf8'}):; 


function blogPage (entries) { 
var values = {entriegs: entries}: 
return ejs.render(template, {locals: values}); 


} 
EJS 柑 板 文件 中 有 HTML 标 记 ( 让 它 下 在 程序 逻辑 之 外 )， 以 及 指出 把 传 给 模板 引擎 的 数据 放 
在 哪里 的 占 位 符 。 展 示 博 客 文 草 的 EJS 模 板 文 件 中 应 该 包含 下 面 这 样 的 HTML 和 占 位 符 : 


代码 清单 11-4 ”显示 博客 文章 的 EJS 模 板 


<html> 
<head> 
<Style type="text/css"> 
.entry title { font-weight: bold; } 
.entry_ date { font-style: italic; } 
.entry _ body { margin-bottom: lem; } 














</style> 
循环 遍历 | </head> 
博客 文章 | -ua 2 
的 占 位 符 < 名 entries.map (function (entry) %$> ee 
<div class="entry_title"><%= entry.title %></div> 所 项 数据 的 万 位 得 


<div class="entry date"><%= entry.date %></div> 


<div class="entry body"><%= entry.body %®></div> 
< 和 当 }); 名 > 
</body> 
</html> 


Node 社 区 创建 的 模块 中 也 有 模板 引 敬 ,并 且 种 类 繁多 。 如果 你 觉得 HTML 和 /或 CSS 不 够 优雅， 
为 HTML 需要 闭合 标签 ， 而 CSS 需 要 左右 大 括号 ， 那 么 你 可 以 认真 研究 一 下 模板 引擎 。 它 们 可 
以 用 特殊 的 “语言 ”( 比如 Jade 语 言 , 我们 后 面 会 讲 到 ) 以 更 简洁 的 方式 表示 HTML 或 CSS, 或 者 
两 者 莱 而 有 之 。 

这 些 模板 引擎 可 以 让 你 的 模板 更 整洁 ， 但 你 可 能 不 想 花 时 间 去 学 另外 一 种 表示 HTML 和 CSS 
的 办 法 。 你 决定 用 什么 最 终 还 是 取决 于 你 的 个 人 喜好 。 

在 本 草 的 后 续 章 玫 中 , 我 们 会 介绍 三 个 流行 的 模板 引擎 ,以 及 如 何 通过 它们 把 模板 引入 到 你 
的 Node 程 序 中 : 

口 Embedded JavaScript ( EJS ) 引擎 

口 针 循 极 简 主 义 的 Hogan 引 擎 

口 Jade 模 板 引 擎 

这 些 引 擎 中 的 任何 一 个 都 允许 你 用 另外 一 种 方式 编写 HTML。 我 们 先 从 EJS 开 始 。 


11.2 ”和 骨 入 JavaScript 的 模板 


Embedded JavaScript ( https://github.comy/visionmedia/ejs ) 处 理 模 板 的 方式 相当 地 简单 直接 ， 
对 于 在 其 他 语言 中 用 过 模板 的 人 来 说 ， 它 应 该 有 种 似曾相识 的 感觉 ， 就 像 JSP ( Java )、Smarty 
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(PHP )、ERB ( Ruby ) 等 等 。EJS 人 允许 你 把 EJS 标 签 当 做 给 数据 准备 的 占 位 符 通 入 到 HTML 中 。EJS 
还 让 你 在 模板 中 执行 原始 的 JavaScript 逻 辑 , 完成 条 件 分 文 和 循环 之 类 的 任务 , 就 像 PHP 做 的 那样 。 

本 节 会 讲解 如 何 : 

口 创建 EJS 模 板 ; 

口 用 EJS 过 滤器 提供 常用 的 、 与 展示 相关 的 功能 ， 比 如 文本 人 处理 、 排 序 和 循环 ; 

口 在 你 的 Node 程 序 中 集成 EJS ; 

口 把 EJS 用 在 客户 端 程序 中 。 

接 下 来 我 们 要 深入 到 EJS 模 板 的 世界 中 。 


11.2.1 创建 模板 


在 模板 的 世界 中 ， 发 送 给 模板 引擎 做 演 染 数据 有 时 被 称 为 上 下 文 。 下 面 这 个 简单 的 Node 程 
序 使 用 EJS 把 上 下 文 渲染 到 一 个 简单 的 模板 中 : 











Var es = require('ejs'); 
var template = '<%= message 省 > 
var context = {message: 'Hello template!'}; 


console.log(ejs.render(template, {locals: context}}))}); 

注意 render 的 第 二 个 参数 locals。 第 二 个 参数 可 以 包含 泻 染 选 项 以 及 上 下 文 数据 ， 也 就 是 
说 是 用 locals 可 以 确保 上 下 文中 的 单项 数据 不 会 被 当 作 EJS 选 项 。 但 大 多 数 情况 下 你 都 可 以 把 上 
下 文本 里 当 作 第 二 个 参数 ， 就 像 下 面 的 render 一 样 : 

console.log(lejs.render (temolate, context)); 

如 果 你 把 给 EJS 的 上 下 文 直接 当 作 render 的 第 二 个 参数 , 一定 不 要 给 上 下 文中 的 值 用 这 些 名 
称 : cache、client、close、compileDebug、debug、filename、open 或 scope。 它们 是 
可 以 修改 模板 引擎 设 定 的 保留 字 。 

字符 转 义 

在 泻 染 时 ，EJS 会 转 义 上 下 文 值 中 的 所 有 特殊 字符 ， 将 它们 蔡 换 为 HTML 实 体 码 。 这 是 为 了 
防止 跨 站 脚本 (XSS ) 攻击 ， 恶 意 的 用 户 会 将 JavaScript 作 为 数据 提交 给 Web 程 序 ， 希望 其 他 用 户 
访问 包含 这 些 数据 的 页 面 时 能 在 他 们 的 浏览 带 中 执行 。 下 面 的 代码 展示 了 EJS 的 转 义 处 理 : 




















var ejs = require('eijs'); 
Var template = < 多 = message %®>',， 
var context = {message: "<script>alert('XSSs attack!'});</script>"}; 





console.loglejs.render(template, context)}); 

这 段 代码 在 显示 时 会 输出 下 面 这 种 代码 : 

&lt;script&gt;alert('xXSS attack!');&lt;/script&gt; 

如 条 你 相信 用 在 模板 中 的 数据 ， 不 想 转 义 出 现在 EJS 模 板 中 的 上 下 文 值 ， 可 以 用 <g%- 代 符 <%=， 
像 下 面 的 代码 这 样 : 
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var ejs = require('ejs').; 
Var template = '<%- message %>!,， 
Var context = { 
message: <script>alert{('Trusted JavaScripti!'!);</script>" 


}; 
console.log(ejs.render (template, context))}).; 


注意 ! 如 采 你 不 喜欢 EJS 的 标签 ， 可 以 定制 它们 ， 像 这 样 : 











Var ejs = regquire('ejs'); 

ejs.open = 1{{:! 

ejs.close = '}}:' 

var template = '{{= message }}'; 

var context = {message: 'Hello template!'}:; 





console.logleijs.render (template, context}))}):; 


你 已 经 掌握 了 EJS 的 基础 知识 , 接 下 来 我 们 要 介绍 一 些 东 西 ,让 你 可 以 更 容易 地 管理 数据 的 展示 。 


11.2.2 ”用 EJS 过 滤器 处 理 模板 数据 


EJS 文 持 过 滤 天 一 一 一 个 可 以 让 你 轻松 完成 数据 转换 的 特性 。 为 了 表明 你 正在 用 过 滤 硕 ， 要 
在 EJS 的 开始 标签 中 添加 一 个 冒号 〈: )。 比 如 : 

口 <s= :是 用 在 转 义 的 EJS 输 出 上 的 过 滤 句 。 

口 <$-: 是 用 在 非 转 义 的 EJS 输 出 上 的 过 滤 需 。 

过 滤 希 也 可 以 链 起 来 ， 也 就 是 说 你 可 以 把 多 个 过 滤 硕 放 在 一 个 EJS 标 签 上 ， 显 示 所 有 过 滤 协 
的 票 加 效果 (类 似 于 *UNIX 中 的 “管道 ” )。 在 接 下 来 的 几 节 中 ， 我 们 会 介绍 几 个 帝 用 的 过 滤 需 。 

1. 处 理 选 择 的 过 滤器 

EJS 过 滤 希 是 放 在 EJS 标 签 里 的 。 为 了 让 你 对 过 滤 融 的 用 处 有 个 直观 的 认识 , 我 们 假定 有 个 分 
享 电 影 的 程序 , 用 户 可 以 告诉 人 们 他 们 看 过 哪些 电影 。 其 中 最 重要 的 信息 可 能 是 他 们 最 近 看 过 的 
一 部 电影 。 在 下 面 这 个 例子 中 , 模板 中 的 EJS 标 签 用 1ast 过 滤 需 显示 电影 数组 中 的 最 后 一 部 影片 ， 
而 last 过 滤 硕 的 功能 就 是 只 取出 数组 的 最 后 一 项 : 
































var ejs = require('ejs'); 
var template = '<%®=: movies | last %>'; 
Var context = {'movies': [ 

'Bambi', 


'Babe: PIG in the City', 
'Enter the Void' 
| 





console.log(ejs.render (template, context)); 

first 也 是 个 过 滤 絮 。 如 果 你 想得到 列表 中 的 指定 条 目 ， 可 以 用 过 滤器 get。EJS 标 签 <%=: 
movies | get:1 %> 会 显示 movies 数 组 中 的 第 二 个 条 目 (因为 条 目 0 才 是 第 一 个 )。 如 果 上 
下 文 值 不 是 数组 ， 而 是 一 个 对 象 ， 你 也 可 以 用 get 过 滤 需 显示 它 的 属性 。 

2. 处 理 大 小 写 的 过 滤器 

EJS 过 滤 带 还 可 以 用 来 改变 大 小 写 。 下 面 模板 中 的 EJS 标 签 中 有 一 个 过 小 各 , 它 可 以 把 上 下 文 
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值 中 的 第 一 个 字母 变 成 大 与 的 ， 在 这 个 例子 中 是 把 “bob” 显 示 成 “Bob : 


var ejs = require('eijs'); 
var template = '<%=:; name | capitalize %>'; 
Var context = {name: 'bob'}; 





console.log(leijs.render (template, context}))}):; 

如 有 末 你 想 把 上 下 文 值 全 部 用 大 写 显 示 ， 可 以 用 upcase。 相 反 ， 过 滤 融 daowncase 会 把 值 显 示 成 
小 写 。 

3. 处 理 文本 的 过 滤器 

EJS 过 滤 硕 可 以 切割 文本 。 你 可 以 鹤 断 文本 ， 在 文本 上 妃 加 或 前 置 内 容 ， 甚 至 答 换 其 中 的 部 
分 内 容 。 把 文本 和 截断， 只 留 下 一 定数 量 的 字符 可 以 防止 长 字符 串 破 坏 HTML 布 局 。 比 如 下 面 这 段 
代码 ， 会 把 标题 蕉 成 只 有 20 个 字符 的 字符 串 ， 显 示 “The Hills are Alive ”: 


Var eijs = require('e]js').; 
Var template = '<%®=: title | truncate:20 %>'; 
Var context = {title: 'The Hills are Alive With the Sound of Critters'}: 


























console.log(ejs.render (template, context))}); 

如 果 你 想 把 文本 截 成 一 定数 量 的 单词 ，EJS 过 滤器 也 可 以 做 到 。 你 可 以 把 前 面 那个 例子 中 的 
EJS 标 签 换 成 <%$=: title | truncate words:2 %>, 把 上 下 文 值 截 成 2 个 单词 。 然 后 输出 会 
变 成 “The Hills”。 

过 滤 关 zeplace 底 层 用 的 是 String. prototype.replace (pattern) ， 所 以 它 可 以 接受 字 

符 串 或 正则 表达 式 。 下 面 这 段 代 码 用 EJS 过 滤 需 把 单词 蔡 换 成 缩写 词 





var es = TequIrel ' ee]s') ， 
var template = "<%=: en | replace: 'kilogram', 'kg' %> 
Var context = {welight: '40 kilogram'}:; 





console.log(ejs.render (template, context}}.; 


你 可 以 用 过 滤 融 追加 文本 ， 比 如 appenaq:'some text'。 同 样 ， 你 也 可 以 用 过 滤 需 在 文本 
前 面 添加 文本 ， 比 如 prepend:'some text'。 

4. 排序 的 过 滤器 

EJS 过 滤 右 还 可 以 排序 。 我 们 还 是 回 到 前 面 用 的 那个 电影 标题 的 例子 中 , 你 可 以 用 EJS 过 滤 帮 
按 标 题 对 电影 进行 排序 ， 并 按 字 母 表 的 顺序 显示 第 一 部 影片 ， 如 图 11-3 所 示 。 


MOWV1ES | sort | 和 六 如 万 


Babe: Pig in the City | Babe: Pig in the City 
| Babe: Pig in the City | Bambi | 
| Enter the Void ] Enter the Void ] 


图 11-3 ”用 EJS 过 滤 需 处 理 文 本 数组 的 示意 图 
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下 面 是 实现 这 一 处 理 的 代码 : 


var ejs = require('ejs'); 
var template = '<%=: movies | sort | first %>'; 
Var context = {'movies': [ 

'Bambi', 


'Babe: Pig in the City', 
'Enter the Void'! 
]}; 





console.loglejs.render (template, context)); 


如 末 你 想 对 由 对 象 组 成 的 数组 进行 排序 ,而 排序 的 标准 是 对 和 象 的 属性 , 可 以 用 过 滤 冀 这 样 做 : 











Var ejs = require('ejs').; 
Var template = "<%=: movies | sort_by:'name' | first | get:'name' %$>"; 
Var context = {'movies': [ 

{name: 'Babe: Pig in the City'}, 

{name: 'Bambi'}, 


{name: 'Enter the Void'} 


| 

console.log(lejs.render(template, context}))}); 

注意 过 滤 需 链 最 后 的 get : 'name'。 因 为 sort 返 回 的 是 对 象 ， 而 你 还 要 选择 显示 对 象 的 哪个 
属性 。 

5. 过 滤器 map 

你 可 以 用 EJS 过 滤 融 map 指 定 要 由 后 组 过 滤 希 处 理 的 对 象 属性 。 对 于 前 面 那个 例子 而 言 ， 你 
也 可 以 在 过 滤 需 链 中 使 用 map。 你 不 必 非 得 用 sort_by 指 定 属 性 ， 然 后 再 用 get 指 定 要 显示 的 属 
性 。 你 可 以 用 map 创 建 一 个 包含 对 象 属性 的 数组 。 结 采 EJS 标 签 会 变 成 <%=: movies | map: 
'name' | sort | first %>。 

6. 创建 定制 的 过 滤器 

尽管 EJS 提 供 了 最 稼 用 的 过 滤 硕 , 但 有 时 你 需要 的 东西 可 能 超出 了 EJS 的 范围 。 比 如 说 ， 如 末 
你 需要 一 个 对 小 数位 做 四 舍 五 人 的 过 滤 融 , 你 会 发 现 没 有 内 置 的 过 滤 病 可 以 帮 你 做 这 个 。 不 过 EJS 
人 允许 你 添加 目 己 定制 的 过 滤 硕 ， 并 且 很 容易 ， 允 像 下 面 这 样 : 


代码 清单 11-5 ”定义 你 目 己 定制 的 EJS 过 滤 硕 




















var ejs = require('ejs'); 

var template = '<%=: price * 1.145 round:2 %>';，; 

var se 二 ee 在 ejs.filters 对 象 

上 定义 一 个 函数 
ejs.filters.round = ftunct1lon(number，qeclimalPlaces) { 
ee ee 二 ee | 第 一 个 参数 是 输入 值 、 
ecima aces = ldecima aCes 7? : decima aces; 、 、 EK 
工 工 上 人 下文， 或 前 一 个 过 滤 
var multiple = Math.pow(10, decimalPlaces).; 器 的 结果 


return Math.round(number * multiple) / multiple; 
}; 


console.log(eijs.render (template, context)}))}); 


如 你 所 见 ，EJS 中 的 filters 提 供 了 一 种 非 笛 棒 的 办 法 ， 可 以 减少 你 为 显示 准备 数据 所 写 的 
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代码 。 你 不 用 在 泻 染 模板 之 前 手动 转换 这 些 数据 ，EJS 提 供 了 很 棒 的 内 置 机 制 带 你 实现 它 。 


11.2.3 ”将 EJS 集 成 到 你 的 程序 中 


因为 把 模板 和 代码 放 在 同一 个 文件 里 很 别扭 , 并 且 这 样 会 把 代码 弄 乱 , 所 以 我 们 会 告诉 你 如 
何 用 Node 的 API 从 独立 的 文件 中 读 取 模板 。 
进入 你 的 工作 目录 ， 创 建 一 个 名 为 app.js 的 文件 ， 把 下 面 的 代码 放 在 里 面 。 


代码 清单 11-6 ”把 模板 代码 放 在 文件 中 





var ejs = require('ejs'); 
var fs = require('fs'); 
Var http = require('http'); 注意 模板 
Var filename = './template/students.ejs'; 文件 的 位 置 
Var students = |[ 传 给 模板 

{name: 'Rick LaRue', age: 23}, 引擎 的 数据 


{name: ' Sarah Cathands', age: 25}, 
{name: 'Bob Dobbs', age: 37} 
I 


Var ServVer = htto,.createServer(function(reg, res) { < 一 创建 HTTP 服 务 器 
if (req.url == '/') { 
fa. readFile(filename, function(ere, Gata) 于 < 一 从 文件 中 读 取 模板 
Var template = data.toString().; 


Var Context = {students: students}; 
Var output = ejs.render (template, context).， < 一 泻 染 模板 
res.setHeader('Content-type', 'text/html'); 
res.end (output).; < 发送 HTTP 响 应 
了 
} else { 
res.statusCode = 404,， 


res.end!{'Not found').; 
} 
上 


server.listen(8000).， 
a 目录 。 模板 将 会 被 放 到 这 个 月 录 下 。 在 template 目录 下 
创建 students.ejs 文 件 ， 这 样 你 的 程序 结构 看 起 来 应 该 像 图 11-4 一 样 。 











后 app.js 


和 template 





| students.ejs 


图 11-4” ”EJS 程序 的 结构 
把 下 面 的 代码 放 到 students.ejs 中 。 
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代码 清单 11-7 ” 演 染 学 生 数 组 的 EJS 模 板 
<% 1if (students.length) { %> 
<ul> 
< 各 students.forEach(function(student) { %> 
<]i><$%= student.name $$> (<%= student.age %>})</1i> 
< 省 ) 名 > 
</ul> 
< 客 】 儿 > 


缓存 EJS 模 板 
EJS 可 以 在 内 存 中 绥 存 模板 消 数 , 这 是 一 个 可 选 的 特性 。 也 就 是 说 在 EJS 中 , 解析 完 模板 文件 
可 以 把 解析 得 到 的 函数 存 下 来 。 因 为 可 以 跳 过 解析 步 纤 ， 所 以 演 染 缓存 的 模板 速度 更 快 。 
如 果 是 Node 程 序 的 初步 开发 , 并 有 旦 你 想 马 上 看 到 修改 的 效 采 ,可 以 不 启用 绥 存 。 但 在 把 程序 
部 署 到 生产 环境 中 时 ， 局 用 缓存 是 一 种 简单 快捷 的 制胜 之 站。 你 可 以 通过 环境 变量 NODE_ENV 设 
定 是 否 局 用 缓存 的 条 件 。 

如 有 果 你 想 尝 试 一 下 绥 存 机 制 ， 将 前 面 的 render 抑 数 调 用 改 成 下 面 这 样 : 





后 


3 














Var Cache = process.env .NODE ENV === ‘'Production': 
var output = ejs.render 
template, 


{students: students, cache: cache, filename: filenamel} 
); 
注意 ， 中 中 的 选项 fi1 ename 不 一 定 必须 是 文件 你 可 以 用 你 要 尝 桨 的 模板 的 唯一 标识 o 
看 过 如 何 把 EJS 集 成 到 Node 程 序 中 之 后 ， 我 们 去 看 看 EJS 的 另 一 种 使 用 方式 : 在 浏览 帮 中 。 

















11.2.4 ”在 客 己 端 程 序 中 使 用 EJS 


我 们 已 经 给 出 了 一 个 在 Node 中 使 用 EJS 的 例子 ; 现在 要 快速 浏览 一 下 如 何在 浏览 硕 中 使 用 
EJS。 要 在 客户 端 使 用 EJS， 首 先 要 把 EJS 引 擎 下 载 到 你 的 工作 目录 中 ， 命 令 如 下 所 不: 


cd /your/working/directory 
curl https://raw.github.com/visionmedia/ejs/master/ejs.js -oO ejs.js 


下 载 完 ejsjs 文 件 ， 你 束 可 以 在 客户 端 代码 中 使 用 EJS 了。 下 面 是 一 个 简单 的 EJS 客 户 剖 程序 。 
代码 清单 11-8 ”用 EJS 给 客户 端 增加 使 用 模板 的 能 


<html> 
<head> 
<title>EJS example</title> 
<script src="ejs.jJSs"></script> 





<script 
引入 jQuery src="http://ajax.googleapis.com/ajax/libs/jquery/1.8/jquery.js"> 
库 做 DOM 处 </script> 
理 </head> 
<body> | 用 来 浑 染 模板 输出 
的 占 位 标签 
< TGSsTOUEBUOEIS<aQLS 人 
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<script> 泻 染 内 容 
Var template = "<%= message %>"， 用 的 模板 
var context = {message: 'Hello template!'}; 
用 在 模板 
中 的 数据 | $s (document) .ready (function() { 等 着 浏览 器 
$('#output') .html ( 加 载 数 据 
ejs.render (template, context) 
和 将 模板 泻 染 到 ID 为 
Fj "output" 的 div 中 
</script> 
</body> 
</html> 


学 完 这 个 功能 完备 的 Node 模 板 引 苟 ， 该 去 看 一 下 Hogan 模 板 引 擎 了 , 它 特 意 限 制 了 模板 代码 
中 可 用 的 功能 。 


11.3 ”使 用 Mustache 模板 语言 与 Hogan 


Hogan.js ( https://github.com/twitter/hogan.js ) 是 Twitter 为 满足 目 己 对 模板 的 需求 而 创建 的 模 
板 引 擎 。Hogan 实 现 了 流行 的 Mustache ( http://mustache.github.com/ ) 模板 语言 标准 ， 这 一 标准 是 
由 GitHub 的 Chris Wanstrath 创 建 的 。 

Mnustache 遵 循 极 简 主 义 的 模板 方式 。 跟 EJS 不 同 ，Mustache 标 准 特意 去 择 了 条 件 逻 辑 ， 除 了 
为 防止 XSS 攻 击 而 保留 | 转 义 能 力 ，Mustache 也 没有 其 他 任何 内 置 的 内 容 过 滤 能 力 。Mustache 主 
张 模板 代码 应 “" 也 简单 。 

本 节 将 介 

口 ls 程序 中 创建 和 实现 Mustache 模 板 ; 

口 Mustache 标 准 中 的 各 种 模板 标签 ; 

口 如 何 用 “局 部 ”组 织 模板 ; 

口 如 何 用 你 自己 的 分 隔 符 和 其 他 选项 对 Hogan 进 行 微 调 。 

我 们 去 看 看 Hogan 提 供 的 另 一 种 使 用 模板 的 方式 。 


11.3.1 创建 模板 


在 程序 中 使 用 Hogan， 或 答 试 本 节 中 的 例子 ， 需 要 在 你 的 程序 目录 中 安装 Hogan。 因 此 请 在 
你 的 命令 行 中 输入 下 面 这 条 命令 : 

npm install hogan.js 

下 面 是 一 个 简单 的 Node 程 序 示例 ， 它 用 Hogan 泻 染 一 个 使 用 了 上 下 文 的 简单 模板 。 运 行 它 会 
输出 “Hello 本 


var hogan = require('hogan.s').;: 
var template = '{{message}}'; 
var context = {message: 'Hello template!'}, 
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var template = hoganconmpI1e termnoD1ar 人 ) ， 
console.log(template.render (context)).; 


你 已 经 知道 如 何 用 Hogan 处 理 Mustache 模 板 了 ， 接 下 来 我 们 去 看 看 Mustache 文 持 哪些 标签 。 


11.3.2 Mustache 标签 


Mustache 标 签 在 概念 上 跟 EJS 的 标签 类 似 。Mustache 标 签 是 变量 值 的 占 位 符 ， 指 明 哪里 需要 
循环 ， 并 人 允许 你 增强 Mustache 的 功能 ， 在 模板 里 添加 注释 。 

1. 显示 简单 的 值 

在 Mustache 模 板 中 显示 上 下 文 值 需要 把 值 的 名 称 放 在 双 大 括号 中 。 大 括号 在 Mustache 社 区 里 
被 称 为 “胡须 ”。 比 如 说 ， 如 果 你 想 显 示 上 下 文 项 name 的 值 ， 应 该 用 Hogan 标 签 { {name}}。 

跟 大 多 数 模板 引擎 一 样 ，Hogan 默 认 也 会 对 内 容 进行 转 义 以 防止 XSS 攻 击 。 如 果 要 在 Hogan 
中 显示 未 转 义 的 值 ， 既 可 以 把 上 下 文 项 的 名 称 放 在 三 条 胡须 中 ， 也 可 以 在 前 面 添加 一 个 & 符 号 。 
还 是 用 前 面 那 个 例子 ,你 可 以 用 {{ {name}}} 显 示 不 做 转 义 处 理 的 上 下 文 值 , 也 可 以 用 { {gname}} 
这 种 格式 的 标签 。 

如 果 你 想 在 Mustache 模 板 中 添加 注释 ， 可 以 用 这 种 格式 : {{! This is a comment }}。 

2. 区 块 : 多 个 值 的 循环 遍历 

尽管 Hogan 不 允许 在 模板 中 使 用 逻辑 ， 但 它 确实 引入 了 一 种 优雅 的 办 法 ， 可 以 用 Mustache 分 
节 对 上 下 文 项 中 的 多 个 值 做 循环 遍历 。 

比如 下 面 这 个 上 下 文中 ， 有 一 项 的 值 是 一 个 数组 : 
































var context = 上 
students: |[ 
{ name: 'Jane Narwhal', age: 21 }, 


{ name: 'Rick LaRue', age: 26 1 
. 
如 果 你 想 创建 一 个 模板 , 让 每 个 学 牛 都 显示 在 一 个 单独 的 HTML 段 落 中 , 给 出 下 面 这 种 输出 ， 
这 对 Hogan 模 板 来 说 应 该 是 个 很 们 单 的 任务 : 

<p>Name: Jane Narwhal, Age: 21 years old</p> 

<p>Name: Rick LaRue, Age: 26 years old</p> 


下 面 这 个 模板 应 该 能 生成 你 想 要 的 HTML: 


{{#students}} 
<p>Name: {{name}}, Age: {{age}} years old</p> 
{{/students}} 


3. 反 回 区 块 : 值 不 存在 时 的 默认 HTML 

如 有 果 上 下 文 数据 中 的 students 不 是 数组 会 怎么 样 ” 比如 说 ， 如 果 它 的 值 是 单个 对 象 ， 模 板 
会 显示 它 。 但 如 果 相 应 上 下 文 项 的 值 是 undefined 或 false， 或 者 空 数 组 ， 则 分 节 不 会 显示 。 

如 果 你 想 让 模板 输出 一 条 消息 ， 指 明 该 区 块 的 值 不 存在 ，Hogan 支 持 Mustache 的 反 向 区 块 。 
如 有 果 把 下 面 的 模板 代码 添加 到 前 面 那 个 显示 学 生 的 模板 上 , 在 上 下 文中 没有 学 后 数据 时 ,， 则 会 显 
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示 一 条 消 县 。 
{{^students}} 


<p>No students found.</p> 
{{/students}} 


4. 区 块 lambdas: 区 块 内 的 定制 功能 

为 了 给 开发 人 员 提 供 增强 Mustache 功 能 的 机 会 ，Mustache 标 准 允 许 你 定义 的 区 块 标 签 通过 也 
数 调用 处 理 模 板 内 容 ， 不 用 循环 过 历数 组 。 这 被 称 为 区 块 lambda。 

代码 清单 11-9 是 一 个 使 用 区 块 jambda 的 示例 ,展示 了 在 泻 染 模板 时 如 何 用 它 实现 对 Markdown 
的 支持 。 这 个 例子 中 用 到 了 github-flavored-markdown 模 块 ， 需 要 你 在 命令 行 中 输入 npm install 
github-flavored-markdown 安 装 。 


在 下 面 这 段 代 码 中 , 模板 中 的 x*Name** 传 给 由 区 块 lambda 调 用 的 Markdown 解 析 硕 ， 生 成 了 


<strong>Name</strong>。o 


代码 清单 11-9 在 Hogan 中 使 用 lambda 











var hogan = require('hogan.js'); 
var md = require('github-flavored-markdown'); < 引入 Markdown 解 析 器 
Var template = '{{#markdown}}' 
3 Mustache 模板 中 Markdown 
Var context = { 
name: 'Rick LaRue', 
markdown: function() { 
return function(text) { 
七 d. 起 ECEys 。 7 
人 模板 上 下 文中 包含 一 个 解析 
) " Markdown 的 区 块 lambda 


> 


var template = hogan.compile (template); 
console.log(template.render (context)).; 


使 用 区 块 lambda 可 以 在 模板 中 轻松 实现 缓存 和 转换 机 制 等 功能 。 

5. 子 模板 : 在 其 他 模板 中 重用 模板 

在 编写 模板 时 ， 要 避免 在 多 个 模板 中 不 必要 地 重复 编写 代码 。 一 种 解决 办 法 是 创建 子 模板 
( partials )。 子 模板 是 包含 在 其 他 模板 内 的 构件 。 它 的 另 一 个 用 途 是 把 复杂 的 模板 分 解 成 简单 模板 。 

比如 下 面 这 个 例子 ， 用 子 模板 将 显示 学 生 数 据 的 模板 代码 从 主 模板 中 分 离 出 来 。 


代码 清单 11-10 在 Hogan 中 使 用 子 模板 














Var hogan = require('hogan.Js'); 用 于 子 模 
Var studentTemplate = '<p>Name: {{name}}, 板 的 代码 
+ 'Age: {{age}} years old</p>'; 


'{{#students}}' < 一 主 模板 代码 
'{{>student}}'! 
'{{/students}}'; 


var mainTemplate 


二 十 几 
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Var context = { 
students: [tf 
name: 'Jane Narwhal', 
age:; 21 


name: 'Rick LaRue', 


age: 26 
}] 
}; 
编译 主 模板 
var template = hogan.compile (mainTemplate).; 和 子 模板 
Var partial = hogan.compile(studentTemplate).; 
Var html = template.render (context, {student: partial}); 泻 染 主 模 板 
console.log (html); 和 子 模板 


11.3.3 微调 Hogan 


Hogan 用 起 来 相当 人 简单 一 一 一 旦 掌握 了 它 的 标签 汇总 表 ， 你 就 可 以 开动 了 。 在 使 用 时 可 能 只 
需要 调整 其 中 的 一 两 个 地 方 。 

如 果 你 不 喜欢 Mustache 风 格 的 大 括号 ， 可 以 给 compile 方 法 传人 一 个 参数 黎 盖 Hogan 所 用 的 
分 陋 符 。 下 面 的 例子 把 EJS 风 格 的 分 隔 符 编译 在 Hogan 中 : 

hogan.compile(text, {delimiters: '<®$ $$>'}); 

如 果 你 不 想 在 开始 胡须 中 使 用 以 # 开 涉 的 区 块 标签 ， 可 以 用 compile 方 法 的 男 一 个 参数 : 
sectionTags。 比 如 说 ， 你 可 能 想 让 采用 了 lambda 的 区 块 标 签 使 用 不 同 的 标签 格式 。 下 面 的 代 
人 码 清单 对 前 面 11-9 中 的 例子 做 了 改动 ， 用 下 划 线 前 绥 把 区 块 标 签 markdqown 跟 后 绥 没 有 采用 
lambda 的 循环 区 块 标签 区 别 开 。 


代码 清单 11-11 在 Hogan 中 使 用 定制 的 区 块 标签 


var hogan = regquire('hogan.js'); 
var md = T6000irTe tt"olithib=flavored=-markdom < 一 引入 Markdown 解 析 器 


A < 一 在 模板 中 使 用 定制 标签 


+ '**Name**: {{name}}.' 
+ '{{/markdown}}'; 





























var template 


var context = { 
name: 'Rick LaRue', 
markdown: function(text) f < 一 定制 标签 的 Lambda 


return md.parse (text).: 
} 
i 


var template = hogan.compilel 


template, _ 定制 开始 和 结束 标签 


{sectionTags: [{o: '_markdown', c: 'markdown'}]} 


console.log(template.render (context)).; 
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在 使 用 Hogan 时 ， 你 无 需 修改 任何 参数 来 启用 缓存 。 绥 存 是 内 置 在 compile 子 数 中 的 ， 并且 
是 默认 局 用 的 。 

学 完 这 两 个 相当 人 简单 直接 的 Node 模 板 引 擎 ,， 接 下 来 我 们 要 去 看 一 下 Jade 模 板 引 擎 ， 它 处 理 展 
示 标 记 的 方式 跟 EJS 和 Hogan 不 同 。 


11.4 用 Jade 做 模板 


Jade ( http://jade-lang.com ) 给 出 了 另外 一 种 表示 HTML 的 方式 。Jade 和 其 他 主流 模板 系统 的 
差别 主要 在 于 它 的 空格 的 作用 。 
Jade 模 板 用 缩 进 表 示 HTML 标 签 的 租 人 关系 。HTML 标 签 也 不 必 明 确 给 出 关闭 标签 ， 从 而 避 
免 了 过 早 关闭 ， 或 根本 就 不 关闭 标签 所 产生 的 问题 。 用 缩 进 还 使 得 模板 看 起 来 不 那么 密集 ,并且 
更 多 于 维护 。 
我 们 用 一 个 简短 的 示例 演示 一 下 ， 看 它 如 何 表示 这 段 HTML: 
<html> 
<head> 
<title>Welcome</title> 
</head> 
<body> 
<div id="main" class="content'"> 
<strong>"Hello world!'"</strong> 
</div> 
</body> 
</html> 
这 上 段 HTML 可 以 表示 成 下 面 这 上 段 Jade 模 板 : 
html 
head 
title Welcome 


body 
div.content#main 

















strong "Hello world!" 

Jade 像 EJS 一 样 ， 可 以 衣 和 人 JavaScript， 可 以 用 在 服务 需 问 或 客户 端 。 但 Jade 还 有 其 他 特性 ， 
比如 模板 继承 和 mixins。 用 mixins 可 以 定义 易于 重用 的 小 型 模板 ， 用 来 表示 芝 用 视觉 元 系 的 
HTML， 比 如 条 目 列 表 和 盒子 。Mixins 很 像 我 们 上 一 市 介绍 的 Hogan.js 子 模板 。 有 了 模板 继承 ， 
那些 把 一 个 HTML 页 面 泻 染 到 多 个 文件 中 的 Jade 模 板 组 织 起 来 就 更 容易 了。 我 们 稍 后 会 详细 介绍 
这 些 特性 。 

要 在 Node 程 序 目录 下 安装 Jade， 请 输入 下 面 这 条 命令 : 

npm install jade 

在 安装 Jade 时 ， 你 也 可 以 带 上 全 局 标志 -g， 因 为 这 样 可 以 使 用 jade 命 令 行 工 具 ， 用 它 将 模板 
演 染 为 HTML 更 快捷 。 下 面 这 条 命令 会 演 染 template/sidebar.jade 文 件 ， 在 template 目 录 下 生成 
sidebar.html 文 件 。 有 了 Jade 命 令 行 工 具 ， 做 Jade 语 法 试验 就 更 容易 了 : 


Jade template/sidebar.jade 
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本 市 将 会 介绍 : 

口 Jade 基 础 知识 ， 比 如 说 明 类 名 、 属 性 和 块 扩展 ; 
口 如 何 用 内 置 的 关键 字 往 Jade 檬 板 里 瀛 加 逻辑; 

口 如 何 用 继承 、 块 和 mixins 组 织 模板 。 

作为 开始 ， 我 们 先 看 看 Jade 用 法 和 语法 的 基础 知识 。 





11.4.1 _ Jade 基础 知识 


Jade 的 标签 名 跟 HTML 一 样 ， 但 抛弃 了 起 始 的 < 和 结束 的 > 字符 ， 并 用 缩 进 表示 标签 的 通 套 。 

标签 可 以 用 .<classname> 关 联 一 或 多 个 CSS 类 。 应 用 了 content 和 sidebar 类 的 div 元 素 
表示 为 : 

div.content.sidebar 


问 标 签 上 添加 #<ID> 可 以 赋予 它 CSSID。 下面 这 段 Jade 给 前 面 那 个 例子 加 上 了 CSS ID featureqd_ 


Content: 


div.content.sidebar#featured content 


div 标 签 的 快捷 表示 法 
因为 HTML 中 经 常 使 用 div, Jade 定 义 了 它 的 快捷 表示 法 。 下 面 这 个 例子 泻 染 出 来 的 HTML 
和 前 面 那 个 例子 一 样 : 


.Content.sidebar#featured content 


你 已 经 知道 如 何 表示 HTML 标 签 、 它 们 的 CSS 类 和 ID 了 ， 接 下 来 我 们 看 看 如 何 指定 HTML 标 
签 的 属性 。 

1. 指定 标签 的 属性 

标签 的 属性 放 在 括号 中 ,每 个 属性 之 间 用 去 号 分 开 。 下 面 的 Jade 表 示 一 个 会 在 新 的 浏览 器 标 
签 中 打开 的 链接 : 

alhref='http://nodejs.org', target=' blank') 

因为 指定 标签 的 属性 可 能 会 使 Jade 代 码 很 长 ， 所 以 模板 引擎 有 一 定 的 灵活 性 。 下 面 这 个 Jade 
也 是 有 效 的 ， 并 且 跟 前 面 那个 效果 一 样 : 


alhref='http://nodejs.org', 
target=' blank') 


你 也 可 以 指定 不 需要 值 的 属性 。 接 下 来 这 段 Jade 示 例 是 一 个 HTML 表 单 ， 其 中 包含 一 个 select 
元 素 ， 有 预先 选 定 option : 


strong Select your favorite food: 




















form 
select 
option(value='Cheese') Cheese 
optionl(lvalue='Tofuyu', selected) Tofwu 
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2. 指定 标签 的 内 容 

在 前 面 那 段 代码 中 还 有 标签 内 容 的 示例 : strong 标 签 后 面 的 “Select your favorite food:”; 第 
一 个 option 后 面 的 “Cheese”; 以 及 第 二 个 option 后 面 的 “Tofu”。 

这 是 Jade 中 指定 标签 内 容 的 常用 办 法 ， 但 不 是 唯一 的 。 尽 管 这 种 风格 在 指定 比较 短 的 内 容 时 
很 出 色 ， 但 如 果 标 签 的 内 容 很 长 ， 却 会 导致 Jade 模 板 中 出 现 超 长 的 代码 行 。 不 过 ， 就 像 下 面 这 个 
例子 一 样 ， 在 Jade 中 可 以 用 | 指定 标签 的 内 容 : 

a is some default text 


| that the user should be 
| provided with. 


如 果 HTML 标 签 ， 比 如 style 和 script， 只 接受 文本 (意思 是 说 它 不 能 般 入 HIML 元 系 )， 
那么 | 字符 完全 可 以 去 反 ， 像 下 面 这 个 例子 这 样 : 
style 
hi 1 
font-size: 6em: 
Color: #9DFFOC; 
} 


用 两 种 办 法 分 别 表示 长 短 两 种 内 容 可 以 让 Jade 模 板 看 起 来 更 优雅 。Jade 还 文 持 为 一 种 表示 骸 
入 的 办 法 ， 块 扩展 。 

3. 用 块 扩展 把 它 组 织 好 

Jade 一 般 用 缩 进 表示 藤 套 ,但 有 时 顷 进 会 形成 过 多 的 空格 。 

比如 说 ， 这 里 有 个 用 缩 进 定义 链接 列表 的 Jade 模 板 : 








ul 
1i 
a(href='http://nodejs.org/') Node.Js homepage 
11i 
a{lhref='http://npmjs.org/') NEM homepage 
1i 


al(href='http://nodebits.org/') Nodebits blog 
如 果 用 Jade 块 扩展 表示 ， 前 面 这 个 例子 可 以 变 得 更 紧 浴 。 有 了 块 扩展 ,你 可 以 在 标签 后 面 用 冒 
写 表示 骸 侠 。 下 面 这 段 代码 生成 的 输出 跟前 面 的 一 样 ， 但 只 有 四 行 代码 ， 而 前 面 那 段 代码 有 七 行 : 
ul 
1i: a(lhref=s'http://nodejs.org/') Node.s homepage 


1i: alhref='http://npmjs.org/') NPM homepage 
11: a(href='http://nodebits.org/') Nodebits blog 


对 于 如 何 用 Jade 表 示 标 记 ， 现 在 你 已 经 有 了 充分 的 认识 ， 接 下 来 我 们 要 看 一 下 如 何 把 Jade 集 
成 到 你 的 程序 中 。 

4. 将 数据 纳入 到 Jade 模 板 中 

数据 传 给 Jade 引 | 苟 的 方式 跟 EJS 一 样 。 模 板 先 被 编译 成 函数 ， 然 后 带 大 上 下 文 调 用 它 ， 以 便 
渲染 HTML 输 出 。 下 面 是 一 个 例子 : 
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VAr 
VAar 
VAr 


VAar 
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Jade = require('jade').; 
template = 'strong #{message}'; 
context = {message: 'Hello temolate!'}: 


fn = JjJade.compile (template).; 


console.log(lfn(context)})),; 
在 前 面 那 个 例子 中 ,模板 中 的 #{message} 是 要 被 上 下 文 值 替 换 掉 的 占 位 符 。 
上 下 文 值 也 可 以 作为 属性 的 值 。 下 面 这 个 例子 会 渲染 出 <a href="http://google.com"> 


</d>: 


VAIr 
VAart 





VAart 


VAr 





jade = require('Jade')}); 
template = 'a(href = url)'; 
context = {url: 'http://goo0gle.com'}:; 


fn = Jade.compile (template}).; 


console.loglitn(context))}).,， 
现在 你 已 经 知道 如 何 用 Jade 表 示 HIML 了 ， 以 及 如 何 给 Jade 模 板 提供 程序 数据 ， 接 下 来 我 们 
去 看 一 下 如 何 把 逻辑 放 到 Jade 中 。 


11.4.2 


Jade 模 板 中 的 逻辑 


在 把 程序 数据 交 给 模板 后 ， 你 还 需要 定义 处 理 数 据 的 逻辑 。 在 Jade 中 ， 你 可 以 把 JavaScript 
代码 下 接 般 入 到 模板 中 ， 从 而 定义 出 数据 处 理 逻 辑 。 像 if 语 句 、for 循 环 、var 声 明 这 样 的 代码 
都 很 常见 。 在 深入 到 具体 细 市 中 去 之 前 ,我们 先 来 看 个 例子 ， 用 Jade 模 板 演 染 通讯 录 ， 让 你 对 如 
何 使 用 Jade 逻 辑 有 个 直观 的 感受 : 


h3.contacts-header My Contacts 


if contacts.length 
each contact in contacts 


-~ var fullName = contact.firstName + ' ' + Contact.lastName 
.Contact~-box 
p fullName 
if contact.isEditable 
DP: a(href='/edit/+contact.1d) Edit Record 
Pp 
case Contact.status 
when 'Active,' 
strong User is active in the system 
when 'Inactive' 
em User is inactive 
When 'Pending' 
| User has a pending invitation 


else 
p You currently do not have any contacts 


我 们 先 看 一 下 和 能 入 到 Jade 模 板 中 的 JavaScript 人 代码 如 何 处 理 输出 。 

1. 在 Jade 模 板 中 使 用 JavaScript 

市 有 -前 绥 的 JavaScript 代 人 码 在 执行 时 不 会 输出 任何 值 。 大 有 = 前 级 的 JavaScript 代 码 会 把 值 输 
出 , 但 为 了 防止 XSS 攻 击 做 了 转 义 处 理 。 但 如 果 你 的 J avaScript 代 人 码 生 成 的 内 容 不 应 该 转 义 ， 可 以 
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用 前 级 !=。 表 11-1 是 这 些 前 


在 Jade 中 ， 有 些 常 用 的 条 件 判 断 和 循环 语句 可 以 不 市 前 级 : 


11.4 用 Jade 做 模板 


级 的 汇总 。 


表 11-1 在 Jade 中 藤 入 JavaScript 的 前 组 
输 ”出 
转 义 的 输出 ( 用 于 不 可 信任 或 不 可 预测 的 值 ， 免 受 XSS 攻 击 ) 
不 做 转 义 处 理 的 输出 ( 用 于 可 信任 或 可 预测 的 值 ) 
没有 输出 

















when、 default、 until、 while、each 和 和 unless。 


Jade 还 允许 你 定义 变量 。 


—- VAar Count = 0 
count = 0 





下 面 两 种 赋值 方式 效 末 是 一 样 的 : 


没有 前 级 的 语句 没有 输出 ， 就 像 前 面 说 的 -前 级 一样 。 


2. 循环 遍历 对 象 和 数组 
Jade 中 的 JavaScript 可 以 访问 上 下 文中 的 值 。 在 下 面 这 个 例子 中 ， 我 们 会 从 文件 中 读 取 一 个 


Jade 模 板 ， 并 给 模板 传递 一 个 包含 俩 条 消息 的 上 下 文 数组 让 它 显示 : 


('Jade'); 


var Jade = require 
var fs = require! 


Le 


); 


Var template = fs.readFil]leSync('./template.jade'); 
var context = { messages: |[ 
'You have logged in successftully.', 


'Welcome back!' 


]}; 


var fn = Jade.compile''template).; 
console.log (fn(context})).,; 


Jade 模 板 中 的 内 容 如 下 : 


- messages.forEach (functicon(message) { 


p= message 


有 | 


最 终 输出 的 HTML 是 : 


<p>You have logged in successfully.</p><p>Welcome back!</p> 


Jade 中 还 有 一 个 非 JavaScript 形 式 的 循环 : 





性 的 循环 志 历 。 


面 这 段 代码 跟前 面 的 例子 效果 一 样 ， 但 用 的 是 each: 


each message in messages 


p= message 


对 和 象 属性 的 循环 塌 历 可 以 和 有 不 同 ， 像 这 样 : 


each value, key in post 


div 
strong #{keyl} 
p value 
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ijf、 else if、 else、case、 


each 语 名 o 用 each 语 人 句 很 容易 实现 数组 和 对 和 象 属 
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3. 条 件 化 浑 染 的 模板 代码 








模板 有 时 要 根据 数据 的 取 值 决定 如 何 显示 它们 。 下 面 是 个 条 件 判 晰 的 例子 , 几乎 有 一 半 的 可 


能 会 输出 script 标 签 : 


- var nn = Math.round(Math.random(}) * 1) + 1 
- if (nn == 1) { 
script 


alert('You win!').; 
= 
条 件 判 断 在 Jade 中 还 有 一 种 更 简洁 的 写法 : 
~ Var mn = Math.round(Math.random(}) * 1) + 1 
i 





ScCript 
alert('You win!'); 


如 果 你 的 条 件 判 断 是 取 反 的 ， 比 如 if (n != 1)，, 可 以 用 Jade 的 unless 关 键 字 : 


- Var n = Math.round(Math.random() * 1) + 1 
unless n == 1 
script 
alert('You win!'); 


4. 在 Jade 中 使 用 case 语 名 


Jade 中 还 有 类 似 于 switch 的 非 JavaScript 条 件 判 断 : case 语 句 。 人 借助 case 语 句 ， 你 可 以 根据 


模板 的 场景 指定 输出 。 





在 下 面 这 个 例子 的 模板 中 ， 我 们 用 case 语 名 以 三 种 不 同 的 方式 显示 博客 的 搜索 结 来 。 如 来 
没有 结果 ,， 则 显示 一 条 相应 的 消息 。 如 果 找 到 一 篇 博客 文章 ， 则 显示 它 的 详细 信息 。 如 采 找 到 的 











博客 文章 有 很 多 篇 ， 则 用 eacph 语 名 循环 遍 历 所 有 文章 ， 显 示 它 们 的 标题 : 
case results.length 
when 0 
DD No results found,. 
when 1 





P= results[0] .content 
defauilt 
each result in results 
p= result.title 


11.4.3 ”组织 Jade 模 板 





模板 定义 好 了 , 接 下 来 你 得 知道 该 如 何 组 织 它 们 。 跟 程序 逻辑 一 样 , 你 肯定 也 不 想 让 模板 文件 








过 大 。 一 个 模板 文件 应 该 对 应 一 个 构件 ， 比如 一 个 页 面 ， 一 个 边栏 ， 或 者 一 篇 博客 文章 中 的 内 容 。 


本 节 会 介绍 几 种 机 制 ， 让 几 个 不 同 的 模板 文件 一 起 演 染 内 容 : 
口 用 模板 继承 组 织 多 个 模板 文件 ; 

口 用 块 前 级 /追加 实现 布局 ; 

口 模板 包含 ; 

口 借助 mixins 重 用 模板 逻辑 。 
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我 们 先 从 Jade 的 模板 继承 开始 。 

1. 用 模板 继承 组 织 多 个 模板 文件 

模板 继承 是 多 个 模板 文件 的 组 织 办 法 之 一 。 从 概念 上 来 讲 ， 模 板 就 像 面向 对 象 编程 中 的 类 。 
一 个 模板 可 以 扩展 男 一 个 , 然后 这 个 再 扩展 另 一 个 。 你 可 以 在 合理 的 范围 内 使 用 尽 可 能 多 层次 的 

这 里 有 个 小 例子 ,我们 用 模板 继承 提供 一 个 简单 的 HTML 包 装 器 , 你 可 以 用 它 包装 页 面 内 容 。 
进入 工作 目录 ， 创 建文 件 夹 ftemplate， 把 例子 中 的 Jade 文 件 放 在 里 面 。 你 会 给 页 面 模板 创建 一 个 
名 为 layout.jade 的 文件 ， 其 中 的 Jade 代 码 如 下 所 示 : 


html 
head 
block title 
body 
block content 


layout.jade 中 有 HTML 页 面 的 基本 定义 和 两 个 模板 块 。 模 板 继 承 用 模板 块 定义 由 后 座 模 板 提 
供 内 容 的 位 置 。 在 layout.jade 中 有 一 个 title 模 板块 ， 让 后 褒 模板 设 定 标题 ， 一 个 content 模 板 
块 ， 让 后 裔 模板 设 定 页 面 上 显示 什么 。 

接 下 来 在 template 日 录 下 创建 一 个 名 为 page.jade 的 文件 。 这 个 模板 会 组 装 title 和 content 
模板 块 . 


extends layout 














block title 
title Messages 


block content 
each message in messages 
p= message 


最 后 演示 一 下 继承 的 用 法 ,添加 下 面 的 代码 ( 修改 了 本 市 前 面 的 一 个 例子 )， 它 会 显示 模板 
的 结 灯 。 


代码 清单 11-12 ”模板 继承 实战 


var Jade = require('jade'}); 





Var fs = require('fs').; 

Var templateFile = './template/page.jade': 

var iterTemplate = fs.readFileSync {templateFile}); 
var context = {messages: | 


'You have logged in successfully.', 
'Welcome back!' 


J}; 


var iterFn = jade.compile! 
iterTemplate, 
{filename: templateFile} 
); 





console.log(iterFn (context))}.; 


接 下 来 我 们 要 介绍 模板 继承 的 为 一 个 特性 : 块 前 级 和 块 妃 加 。 
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2. 用 块 前 缀 / 块 退 加 实现 布局 





layout.jade 中 的 模板 块 没有 内 容 ， 因 此 在 page.jade 模 板 中 设 定 内 容 简 单 





直接。 但 如 果 被 继承 的 模板 中 有 内 容 , 你 也 可 以 用 块 前 级 和 块 追加 ,， 在 原 有 内 容 基础 上 构建 新 内 





在 前 面 那 个 例子 中 ， 
容 ， 而 不 是 替换 它 。 
下 面 的 layout.jade 模 板 中 增加 了 一 个 模板 块 scripts， 其 
标签 : 
et 
heaa 


block title 
block scripts 
script (src= 
body 
block content 


如 果 你 还 想 计 page.jade 模 板 额 外 加 载 jQuery UI 库 ， 


代码 清单 11-13 ”用 块 妃 加 再 加 载 一 个 JavaScript 文 件 


extends layout 
baseUrl1 = 


block title 
title Messages 


block style 
link (rel="stylesheet", 


block append scripts 
script (src= baseUrl+"jquery-ui.jJs") 


block content 
omnit, = 已 
each message in messages 
= COUNE COUNt 二 1 
SCIript 
Ss{function(}) { 
Ss{'"'#message #{count}") 
height: 140, 
modal: true 
}); 
be 


pe 
但 模板 继承 不 是 唯一 一 种 集成 多 个 模板 的 办 法 。 
3. 模板 包含 
Jade 中 的 incluae 命 令 是 另 一 个 组 织 模板 的 工具 。: 
末 你 往 前 面 那个 layout.jade 里 添加 一 行 incluade footer， 


.dialoglt 


+ COUNt + ' "> 
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+ MeSSAage + 


也 可 以 用 incluae 命 令 。 


个 合 令 会 多 和 六 





中 的 内 容 是 一 个 加 载 jQuery 的 script 


'//ajax.googleaplils.com/ajax/libs/Jquery/1.8/jJquery.s') 








可 以 用 下 面 代码 清单 中 的 模板 。 


加 这 个 模板 扩展 了 1layout 模 板 


"http://ajax.googleapis.com/ajax/libs/jqueryui/1.8/" 


| 定义 style 块 
href= baseUrl+"themes/flick/jquery-ui.css") 


把 这 个 scripts 块 追加 到 
layout 中 定义 的 那个 上 


‘</divy> 





个 模板 中 的 内 容 。 如 
最 终 就 会 得 到 下 面 这 个 模板 : 
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html 
heaad 
block title 
block style 
block scripts 
script (src='//ajax.googleapis.com/ajax/libs/Jquery/1.8/Jquery.Js') 
body 
block content 
include footer 


这 个 模板 会 在 layout.jade 的 演 染 输出 中 引入 footer.jade 中 的 内 容 ， 如 图 11-5 所 示 。 


layout.jade 





footer.jade 





footer.jade . 








图 11-5 ”Jade 的 include 机 制 是 在 泻 染 一 个 模板 时 包含 男 一 个 模板 内 容 的 简单 办 法 


比如 说 ， 可 以 用 它 往 layout.jade 中 添加 关于 网 站 的 信息 ， 或 设计 元 素 。 你 也 可 以 指定 文件 的 
扩展 名 ， 包 含 非 Jade 文 件 (比如 include twitter widget.html )。 

4. 借助 mixin 重 用 模板 逻辑 

尽管 Jade 的 ijnclude 命 令 能 帮 我 们 引入 之 前 创建 的 代码 块 , 但 还 不 能 徘 它 构建 可 以 在 页 面 和 
程序 之 间 共 至 的 可 重用 功能 库 。 Jade 为 此 提供 了 专门 的 mixin 命 令 , 你 可 以 用 它 定 义 可 重用 的 Jade 
代码 块 。 

mixin 模 拟 的 是 JavaScript 耳 数 。 它 跟 函 数 一 样 , 可 以 带 参 数 , 并 且 这 些 参 数 可 以 用 来 生成 Jade 
代码 。 

比如 说 吧 ， 你 的 程序 要 处 理 下 面 这 种 数据 结构 : 


var students = | 











{name: Rick LaRue', age: 231}, 
{name: 'Sarah Cathands', age: 25}, 
{name: 'Bob Dobbs', age: 37} 

] 江 


如 条 你 要 定义 一 种 办 法 ,把 从 对 象 中 提取 出 来 的 属性 输出 到 HTML 列 表 里 ， 可 以 像 下 面 这 样 


EE 义 一 个 mixin 5 
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mixin list_ object property (objects, property) 
ul 
each object in objects 
li= obijectlpropertyl] 


然后 你 就 可 以 用 下 面 这 行 Jade 代 人 码 信 助 mixin 显 示 这 些 数 据 : 

mixin list object property (students, ‘'name') 

信 助 模板 继承 、include 语 名 和 mixin， 你 可 以 轻松 地 重用 展示 标记 ， 人 防止 模 板 文件 大 的 超 
出 实际 需要 。 








11.5 小结 


你 已 经 掌握 了 三 个 主流 HTML 模板 引擎 的 工作 机 制 ， 能 用 模板 技术 把 程序 逻辑 和 展示 层 组 织 
好 。Node 社 区 创建 的 模板 引擎 很 多 , 也 就 是 说 如 果 你 不 喜欢 本 草 中 介绍 的 这 三 个 , 也 可 以 看 看 其 
他 的 : https://npmjs.org/browse/keyword/template。 

比如 模板 引擎 Handlebars.js ( https://github.com/wycats/handlebars.js/ ), 它 扩 展 了 Mustache 模 板 
语言 ,添加 了 条 件 标签 和 全 局 lambda 之 类 的 特性 。Dustjs ( https://github.com/akdubya/dustjs ) 优先 
考虑 性 能 和 流 之 类 的 特性 。consolidate.js 项 目 (https://github.com/visionmedia/consolidate.js ) 支持 
很 多 种 Node 模 板 引 擎 ， 它 提供 了 一 个 API， 对 这 些 模板 引擎 的 用 法 进行 抽象 ， 计 你 可 以 在 程序 中 
轻松 地 使 用 多 个 模板 引擎 。 但 如 果 你 什么 模板 语言 都 不 想 学 ， 可 以 看 一 下 Plates ( https://github. 
com/flatiron/plates )， 这 个 模板 引擎 允许 你 坚守 HTML ,， 它 的 引擎 逻辑 会 把 程序 数据 映射 到 标签 里 
的 CSS ID 和 类 上 。 

如 果 你 党 得 Jade 处 理 展 示 层 和 程序 逻辑 分 离 的 方式 很 吸引 你 ， 那 我 们 建议 你 看 一 下 Stylus 
( https://github.com/LearnBoost/stylus )， 这 是 一 个 采用 相似 方式 创建 CSS 的 项 目 。 

你 已 经 集 齐 了 创建 专业 Web 程 序 所 需 的 全 部 知识 。 下 一 章 我 们 要 看 一 看 部 车: 如 何 把 你 的 程 
序 开放 给 全 世界 。 
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EEC 
在 Node 中 更 进一步 





在 本 书 的 最 后 一 部 分 中 ， 我 们 将 会 介绍 一 下 如 何 用 Node 做 些 传统 Web 程 序 之 外 的 东西 ， 
以 及 如 何 用 Socket.io 给 Web 程 序 添 加 实时 组 件 。 还 会 讲 到 如 何 用 Node 创 建 非 HTTP 的 TCP/IP 服 
务 妖 ， 甚 至 是 命令 行 工 具 。 

除了 这 些 新 用 法 ， 我 们 还 会 介绍 Node 社 区 体系 的 运行 机 制 ， 你 如 何在 Node 社 区 寻求 帮 
助 ， 如 何 用 自己 的 作品 回馈 Node 社 区 ， 一 般 是 通过 Node 包 管理 器 存储 库 。 
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部 署 Node 程 序 并 维持 
常 运行 时 间 





本 章 内 容 
D 选择 在 哪里 安置 你 的 Node 程 序 
D 部 署 一 个 典型 的 程序 
D 维持 正常 运行 时 间 以 及 性 能 最 大 化 


开发 Web 程 序 是 一 码 事 儿 ， 而 把 它 放 到 生产 环境 中 是 为 一 个 事 儿 。 在 每 个 Web 平 人 台 上 部 有 各 
种 增强 稳定 以 及 提高 性 能 的 技巧 和 守门，Node 也 不 例外 。 

在 部 普 Web 程 序 时 ， 你 首先 要 考虑 好 把 它 放 在 哪里 。 你 还 要 考 原 好 如 何 监测 并 让 它 你 持 正 党 
运行 。 你 可 能 也 在 想 要 做 什么 才能 证 它 尽 可 能 地 快 。 本 章 会 让 你 对 如 何 解 决 这 些 问题 有 个 大 体 的 
认识 。 

我 们 先 从 选择 在 哪里 安置 你 的 Node 程 序 开始 。 


12.1 安置 Node 程序 


大 多 数 Web 程 序 开发 人 员 都 熟悉 PHP 程 序 。 文 持 PHP 的 Apache 服 务 硕 收 到 HTTP 请 求 时 ， 它 
会 把 请 求 UREL 的 路 径 映射 到 特定 的 文件 上 ，PHP 会 执行 那个 文件 。 这 一 特性 使 得 PHP 程 序 部 署 起 
来 很 容易 : 把 PHP 文 件 上 传 到 文件 系统 中 的 指定 路 径 ， 浏 览 融 台 能 访问 了 。PHP 程 序 不仅 易 于 部 
署 ， 安 置 也 便宜 ， 因 为 服务 天 通 和 帝都 是 由 几 个 用 户 共享 的 。 

Joyent、Heroku、Nodejitsu、VMware 和 Microsoft 等 公司 都 有 专 供 Node 的 云 主 机 服务 ,在 上 面 
部 团 Node 程 序 不 再 困难 。 如 果 你 不 想 费 事 管 理 目 己 的 服务 器 ,或 者 想 从 专 供 Node 的 诊断 中 受益 ， 
比如 Joyent SmartOS 能 测量 出 程序 中 哪 段 逻 辑 执 行 最 慢 ， 可 以 人 研究 下 专 供 Node 的 云 主机 服务 。 
Cloud9 网 站 就 是 用 Node.js 构 建 的 ， 它 甚至 提供 了 一 个 基于 浏览 需 的 集成 开发 环境 (Integrated 
Development Environment，IDE )， 你 可 以 在 其 中 从 GitHub 上 克隆 项 目 ， 通 过 训 览 硕 进 行 开发 ， 然 
后 把 它 部 署 到 一 些 专 供 Node 的 云 主 机 服务 上 ， 如 表 12-1 所 示 。 
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表 12-1 专 供 Node 的 云 主 机 和 IDE 服 务 


名 称 网 站 
Heroku www.heroku.com/ 
Nodejitsu www.nodejitsu.com/ 
VMware 的 Cloud Foundry www.cloudfoundry.com/ 
Microsoft 的 Node.js Azure SDK Www.wWindowsazure.comyen-us/develop/nodejs/ 
Cloud9 IDE http://c9.10/ 





除了 专 供 Node 的 云 主机 ， 你 也 可 以 选择 使 用 目 己 的 服务 大 。 大 多 数 人 一 般 会 选择 Linux 作 为 
Node 服 务 信 ， 它 要 比 专 供 Node 的 云 主机 更 灵活 ， 因 为 你 可 以 安 疙 你 所 需 的 任何 相关 程序 ， 比 如 
数据 库 服 务 带 。 专 供 Node 的 云 主机 所 提供 的 相关 程序 通 帝 都 比较 有 限 。 

然而 Linux 服 务 融 的 管理 是 一 个 专业 领域 。 如 采 你 选择 目 己 处 理 部 署 ， 那 就 要 在 你 所 选择 的 
Linux 变 种 上 做 足 功 诛 ， 确 保 玖 练 掌 握 其 上 的 设置 和 维护 规程 。 


VIRTUALBOX 如果 你 在 服务 器 管理 方面 是 个 新 手 ， 可 以 通过 VirtualBox ( www. 
virtualbox.org/ ) 这 样 的 软件 练 练 手 , 不管 你 的 机 器 上 运行 的 是 什么 操作 系统 ， 它 都 可 以 
在 上 面 运行 一 个 虚拟 的 Linux 主 机 。 


如 果 你 询 悉 关于 服务 带 的 各 种 选择 ， 可 以 直接 跳 到 第 12.2 广 ， 我 们 会 在 那里 开始 介绍 部 署 的 
基础 知识 。 不 过 在 这 里 和 完 看 看 可 用 的 选择 : 

口 专用 服务 带 ; 

口 虚拟 私有 服务 入 ; 

口 通用 的 云 服务 条 。 

接 下 来 我 们 讨论 下 你 安置 Node 程 序 时 的 一 些 选 择 项 吧 。 


12.1.1 专用 的 和 虚拟 私有 服务 器 


你 的 服务 硕 可 以 是 物理 服务 硕 , 通常 被 称 为 专用 服务 磊 , 或 者 是 虚拟 的 。 虚 拟 服 务 帮 运行 在 
物理 服务 器 上 ， 并 得 到 了 物理 服务 器 一 部 分 RAM 、 处 理 能 力 和 人 硬盘 空间 。 虚 拟 服务 咒 模 拟 物 理 
服务 器 ， 你 可 以 用 相同 的 方式 管理 它们 。 一 台 物 理 服务 右上 可 以 运行 多 台 虚 拟 服 务 帮 。 

专用 服务 硕 通 稼 要 比 虚 拟 服务 硕 贯 ， 因 为 其 中 的 组 件 可 能 需要 采购 、 组 痛 和 配置 ,一 般 所 需 
的 设置 时 间 也 会 更 长 。 从 另 一 方面 来 看 ， 因 为 虚拟 私有 服务 郁 (Virtual Private Servers，VPS ) 是 
在 已 有 的 物理 服务 需 内 创建 的 ， 所 以 设置 起 来 更 迅速 。 

对 于 Web 程 序 而 言 ， 如 果 你 不 急 着 扩张 ，VPS 是 很 好 的 搭建 服务 需 的 方案 。VPS 价 格 不 高 ， 
在 有 需要 时 ， 分 配额 外 的 资源 也 容易 ， 比 如 硬盘 空间 和 RAM。 这 些 技术 已 经 成 束 了 了， 并 且 有 很 
多 公司 ， 比 如 Linode (www.linode.comy/ ) 和 Pregmr ( http://premr.com/xen/ ) 让 它 的 启动 和 运行 都 
很 容易 。 

VPS 跟 专用 服务 喜 一 样 ， 一 般 不 能 按 需 创建 。 也 不 能 应 对 快速 扩张 的 使 用 情况 ， 因 为 那 需要 
具备 无 天 人 工 干预 就 可 以 迅速 添加 更 多 服务 融 的 能 力 。 要 应 对 这 样 的 需求 ， 你 应 该 使 用 云 主机 。 
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12.1.2 云 主 机 


云 服 务 骨 跟 VPS 有 个 共同 点 , 它们 部 是 专用 服务 带 的 虚拟 模拟 。 但 跟 专 用 服务 上 和 VPS 相 比 ， 
云 服 务 带 的 优势 在 于 它们 的 管理 几乎 是 完全 自动 化 的 。 你 可 以 用 一 个 远程 接口 或 API 创 建 、 停 止 、 
局 动 和 销毁 云 服务 全 。 

你 为 什么 需要 这 个 呢 ? 这 么 说 吧 , 假定 你 创办 了 一 个 公司 ,你 们 有 一 套 企 业内 网 软件 。 你 乔 
望 客户 可 以 注册 申请 你 的 服务 , 并 在 注册 后 不 久 就 能 访问 和 运行 这 套 软 件 的 目 有 服务 带 。 你 可 以 层 
佣 技 术 人 员 一 天 二 十 四 小 时 玫 这 些 客 户 设置 和 部 著 服 务 骨 ,但 除非 你 有 目 己 的 数据 中 心 , 否则 还 
是 要 跟 专 用 或 VPS 服 务 珊 提供 商 打 交道 ， 以 便 可 以 及 时 提供 所 需 资 源 。 而 云 服 务 表 不 一 样 ， 在 你 
需要 新 的 服务 大 时 ， 可 以 用 管理 服务 珊 通 过 主机 提供 商 开 放 给 你 的 API 回 新 服务 天 发 送 指令 。 有 
了 这 种 目 动 化 水 平 ， 在 你 向 客户 提供 服务 时 就 不 再 需要 人 工 和 干预， 可 以 迅速 完成 。 图 12-1 阐 明了 
如 何 用 云 主机 目 动 化 地 实现 应 用 服务 硕 的 创建 和 销毁 。 


人 或 应 用 逻辑 























云 服 务 提供 商 
管理 控制 台 或 API 








图 12-1 云 服务 需 的 创建 、 局 动 、 停 止 和 销毁 都 可 以 完全 自动 化 


云 服 务 器 的 不 足 之 处 在 于 它们 一 般 都 比 VPS 贵 ， 并 且 要 求 你 掌握 特定 云 平台 的 相关 知识 。 

1. AMAZON WEB 服 务 

Amazon Web 服 务 ( AWS http://aws.amazon.com/ ) 是 资格 最 老 也 是 最 流行 的 云 平 台 。AWS 包 
含 各 种 不 同 的 循 主 相 关 服 务 ， 比 如 email 交 付 、 内 容 交 付 网 络 等 等 很 多 服务 。Amazon 的 Elastic 
Compute Cloud (EC2 ) 是 AWS 的 核心 服务 之 一 ， 让 你 可 以 随 需 创建 云 中 的 服务 需 。 

EC2 虚 拟 服务 需 被 称 为 实例 ,可 以 通过 命令 行 或 基于 Web 的 控制 台 进 行 管理 , 如 网 12-2 所 示 。 
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为 适应 AWS 的 命令 行 需要 花 些 时 间 ， 所 以 对 新 用 户 来 说 基于 Web 的 控制 台 更 适合 。 
AWS Management Console 
AWS Management Console » Amazon EC2 





Mike Cantelon ¥ ' Help 了 
f More... 地 
Elastic Beanstalk  §3 EC2 VPC CloudWatch Elastic MapReduce CloudFront CloudFormation RDS 





Region: 泌 Launch Instance [DD showHide 二 Refresh ， 六 Help 
一 - et ge Viewing:| All Instances [All Instance Types "人 

EC2 Dashboard Name Instance AMI ID Root Device Type State 

Scheduled Events ， 

和 口 empty ， 国 -9d0395f1 ami-76f0061f ebs mi.small ， 国 stopped 

=~ INSTANCES 

Instances No EC2 Instances selected. 

Spot. Raquasts Select an instance above 

Reserved Instances 


= IMAGES 
AMIs 
Bundle Tasks 


-| ELASTIC BLOCK STOR 
Volumes 


© 2008 - 2012, Amazon Web Services LLC or is affiliates. All rights reserved Feedback Support 


Privacy Policy Terms of Use 
An amazoncom, comnany 





图 12-2 ”对 新 用 户 来 说 ， 用 AWS Web 控 制 台 管理 Amazon 云 服务 右 比 用 命令 行人 简单 
好 在 AWS 的 普及 程度 很 高 ， 在 网 上 很 容易 得 到 帮助 ， 相 关 教 程 也 有 很 多 ， 比 如 Amazon 的 
“Amazon EC2 Linux 实 例 入 门 ”( http://mng.bz/cw8n )。 

2. RACKSPACE 云 





Rackspace 云 (www:Tackspace.comycloud/ ) 是 一 个 更 基础 ， 更 易于 使 用 的 云 平台 。 它 的 学 习 
曲线 比较 平缓 , 可 能 会 有 些 吸引 力 , 但 Rackspace 云 提供 的 本 三 相 六 的 “后 和 功 glASW 苑 围 宪 ， 


并 且 它 的 Web 界 面 有 些 笨重 。 你 可 以 通过 Web 界 面 , 或 者 社区 创建 的 命令 行 工 具 管 理 Rackspace 云 
服务 硕 。 


表 12-2 中 是 我 们 本 市 讨 论 的 可 选择 簿 主 的 汇总 。 


表 12-2 ”可 选择 宿主 汇总 


适合 的 流量 增 K 


可 选择 和 宿主 相对 成 本 
缓慢 专用 $$ 
线性 虚拟 私有 服务 絮 $ 
不 可 预测 去 $$9 


你 对 把 Node 程 序 安 置 到 哪里 已 经 有 了 总 体 的 认识 ， 接 下 来 我 们 要 看 一 下 如 何 才 能 让 Node 程 rs 
序 在 服务 大 上 跑 起 来 。 


12.2 部署 的 基础 知识 


假定 你 创建 了 一 个 想 要 展示 的 Web 程 序 , 或 者 创建 了 一 个 商业 应 用 ,在 把 它 放 到 生产 环境 中 
之 前 知 要 测试 一 下 。 你 很 可 能 会 从 一 个 简单 的 部 署 开始 ,然后 再 做 些 工 作 让 它 的 正常 运行 时 间 和 
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性 能 达到 最 优 。 本 节 会 市 看 你 经 历 一 次 简单 、 临 时 的 Git 部 著 ， 并 教 你 如 何 用 Forever 把 程序 跑 起 
来 。 临 时 性 部 车 在 重 局 后 会 丢失 ， 但 它们 的 优势 是 设置 起 来 很 迅速 。 


12.2.1 ”从 Git 存 储 库 部 署 


我 们 快速 过 一 下 使 用 Git 存 储 库 的 基本 部 署 ， 让 你 对 主要 步骤 有 个 直观 的 认识 。 

大 多 数 部 并 都 需要 完成 下 面 这 些 步 又 

(1) 用 SSH 连 接 到 服务 杭 上 ; 

(2) 如 果 需 要 的 话 ， 在 服务 僵 上 安装 Node 和 版 本 控制 工具 ( 比如 Git 和 Subversion ) ; 

(3) 从 版 本 控制 存储 库 中 下 载 程序 文件 ， 包 括 Node 脚 本 、 图 片 和 CSS 样 式 表 ， 放 到 服务 右上 ; 
(4) 启动 程序 。 

这 里 有 个 例子 ， 用 Git 下 载 完 程 序 文 件 后 启动 它 : 

git clone https://github.com/Marak/hellonode.git 


CQ hellonode 
node server.js 


像 PHP 一 样 ,Node 也 不 是 后 台 任 务 。 因 此 我 们 列 出 来 的 这 个 基本 部 署 不 能 断 开 SSH 连接 。SSH 
连接 一 旦 断 开 ,程序 就 会 终止 。 不 过 用 一 个 信 单 的 工具 就 可 以 轻松 地 让 程序 保持 运行 状态 。 
自动 部 署 ”有 几 种 可 以 自动 部 署 Node 程 序 的 办 法 。 其 中 一 种 是 使 用 Fleet 
( https://github.com/substack/fleet ) 这 样 的 工具 ， 可 以 用 git push 部 署 到 一 或 多 个 服务 器 
上 。 更 传统 的 方式 是 用 Capistrano， Evan Tahler 的 博客 Bricolage 上 发 表 了 一 篇 详细 介绍 
文章 “用 Capistrano 部 署 node.js 程 序 ”(http:/mng.bz/3K9H )。 

















12.2.2 ”让 Node 保 持 运 行 


比如 说 你 用 Cloud9 Nog 博 客 程序 ( https://github.conyc9/nog ) 创建 了 一 个 个 人 博客 ， 现 在 你 
想 要 部 蜀 它 ， 并 要 确保 在 你 断 开 SSH 连 接 后 它 仍 能 运行 。 

在 Node 社 区 中 ， 和 针对 这 个 问题 最 第 用 的 人 处理 工具 是 Nodejitsu 的 Forever ( https://github.com/ 
nodejitsu/forever )。 它 能 在 你 断 开 SSH 连 接 后 让 程序 保持 运行 状态 ,在 程序 骨 尝 退出 后 还 能 重启 它 。 
图 12-3 是 Forever 工 作 机 制 的 概念 图 。 

你 可 以 用 sudo 命 令 做 Forever 的 全 局 安装 。 


SUDO 命 令 ”在 做 npm 模 块 的 全 局 安装 时 ( 带 -g 选 项 )， 经 常 需要 在 npm 命 令 前 面 
加 上 sudo (www.sudo.ws/ )， 以 超级 管理 员 的 权限 运行 ppm 命令。 在 你 第 一 次 使 用 sudo 
命令 时 ， 系 统 会 提示 你 输入 密码 。 然 后 再 运行 跟 在 sudo 后 面 的 命令 。 

如 果 你 一 直 跟 着 我 们 ， 现 在 用 下 面 的 命令 安装 Forever: 


sudo npm install -g forever 
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Launches | Application | Relaunches | 
and monitors |， crashes and monitors ， 
| Application ' | Application 








前 


(名 Forever 启 动 你 的 服务 器 程序 
并 对 它 进行 监测 


OE 程序 月 并 后 ，Forever 会 采取 行动 
并 重新 启动 这 个 程序 


图 12-3 ”让 程序 保持 运行 的 Forever， 即 便 程 序 崩 演 也 可 以 
Forever 闭 好 之 后 ， 你 可 以 用 下 面 这 条 命令 启动 你 的 博客 ， 并 让 它 一 直 运 行 下 去 : 


forever start server.js 

如 果 出 于 某 些 原因 你 想 停 止 这 个 博客 ， 可 以 用 Forever 的 stop 命 令 : 

forever stop Servet .]S 

使 用 Forever 时 ， 你 可 以 用 它 的 1ist 命 令 获 取 它 所 管理 的 程序 清单 : 

forever list 

Forever 还 有 一 个 比较 实用 的 功能 ， 当 有 源码 文件 发 生变 化 时 ,可 以 让 它 重 启程 序 。 这样 每 次 
讨 加 新 特性 或 修订 bug 时 ， 你 就 不 用 再 手动 重 局 了 。 

要 在 这 种 模式 下 局 动 Forever， 请 用 -w 选 项 : 

forever -w start server.js 

尽管 Forever 在 程序 部 署 上 是 一 个 极其 实用 的 工具 ,但 你 可 能 想 要 一 些 功能 更 完备 的 东西 做 长 
期 部 署 。 下 一 攻 我 们 会 看 一 些 工 业 级 强度 的 监测 方案 ， 并 看 看 如 何 让 程序 的 性 能 达到 最 优 。 


12.3 ”让 正 帅 运行 时 间 和 性 能 达到 最 优 


Node 程 序 准 备 就 绪 可 以 发 布 后 ,你 会 想 让 它 跟 看 服务 仙 的 启动 而 局 动 ,服务 带 的 集 止 而 集 止 ， 
并 在 服务 占 朋 当时 能 日 动 重 局。 我们 很 容易 起 掉 在 重启 之 前 集 挥 应 用 程序 , 重 局 后 也 会 忘掉 启动 
程序 。 









































还 想 确 保 你 采取 了 能 让 性 能 达到 最 优 的 措施 。 比 如 说 ， 当 程序 运行 在 一 台 有 四 核 CPU 的 服 12 
务 逢 上 时 ， 就 不 应 该 只 用 一 个 核 。 如 有 果 只 用 一 个 核 ， 并 且 Web 程 序 流 量 增长 显著 ， 单 核 可 能 没有 
足够 的 能 力 来 处 理 这 些 流量 ，Web 程 序 也 不 能 做 出 稳定 的 啊 应 。 
除了 用 上 所 有 的 CPU 内 核 ， 对 于 高 容量 的 生产 型 站 点 而 言 ， 还 要 避免 用 Node 传 送 静 态 文 件 。 
Node 主 要 是 面 癌 交互 性 程序 的 ， 比 如 Web 程 序 和 TCP/IP 协 议 , 它 提供 静态 文件 服务 的 效率 不 如 那 
些 专 门 为 此 进行 优化 的 软件 。 提 供 静 态 文 件 服务 应 该 用 Nginx ( http://nginx.org/en/ ) 之 类 的 技术 ， 
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那些 专门 用 来 提供 静态 文件 服务 的 。 或 者 也 可 以 把 所 有 带 态 文件 都 上 传 到 一 个 内 容 交 付 网络 
(CDN ) 上 去 ， 比 如 Amazon S3( http://aws.amazon.com/s3/ )， 并 在 你 的 程序 中 引用 那些 文件 。 

本 节 会 讨论 一 些 跟 服务 需 正 负 运行 时 间 和 性 能 有 关 的 技巧 : 

口 用 Upstart 保 持 程序 的 运行 状态 ， 能 跨越 服务 需 的 重启 和 朋 溃 ; 

口 便 助 Node 的 集群 API 利 用 多 核 处 理 融 ; 

口 借助 Nginx 提 供 Node 程 序 的 静态 文件 服务 。 

我 们 先 来 看 一 个 非常 强大 、 易 于 使 用 的 正常 运行 时 间 维 护 工 具 : Upstart。 

















12.3.1 用 Upstart 维 护 正常 运行 时 间 


假定 你 对 手头 的 程序 很 满意 , 想 把 它 推 器 外 面 的 世界。 你 无 论 如 何 也 不 想 在 重启 服务 器 后 忘 
了 启动 你 的 程序 。 如 果 程 序 骨 演 了 ,你 也 希望 它 不 仪 能 重新 启动 ,还 要 能 在 日 志 中 把 这 次 月 演 记 
录 下 来 ， 并 通知 你 ， 让 你 可 以 对 所 有 相关 问题 进行 诊断 。 

Upstart( http://upstart.ubuntu.com ) 可 以 优雅 地 管理 所 有 Linux 程 序 的 启动 和 停止 ， 包 括 Node 
程序 。Upstart 文 持 现 代 厂 的 Ubuntu 和 CentOS。 

如 果 还 没 安装 ,你 可 以 用 下 面 的 命令 在 Ubuntu 上 安装 Upstart: 

sudo apt-get install upstart 

在 CentOS 上 安装 Upstart 的 命令 是 : 























sudo yum install upstart 
装 好 Upstart 后 ， 需 要 给 你 的 每 个 程序 添加 一 个 Upstart 配 置 文件 。 这 些 文件 要 放 在 /etcinit 目 录 
文件 名 类 似 于 my_application_name.conf。 这 些 配置 文件 不 必 标 记 为 可 执行 的 。 

下 面 这 条 命令 会 给 本 章 的 示例 程序 创建 一 个 空白 的 Upstart 配 置 文件 : 
sudo touch /etc/init/hellonode.conf 
把 下 面 代码 清单 中 的 内 容 添 加 到 你 的 配置 文件 中 。 这 个 设置 会 在 你 的 服务 硕 司 动 时 运行 你 的 
程序 ， 并 在 服务 大 关闭 前 停止 它 。 其 中 的 exec 部 分 由 Upstart 执 行 。 


代码 清单 12-1 上 典型 的 Upstart 配 置 文 件 





7 

















| 指定 程序 的 作者 


author "Robert DeGrimston" 
descridtion "hellonode" 用 nonrootuser 
TO 
设 定 程序 的 setuiqd "nonrootuser" 用 尸 运行 程序 
名 称 或 描述 


网 络 可 用 之 后 


局 动 程序 


系统 启动 时 ， 
start on (looal=-ftiléesystems and net-device-up TFEACE=eth0) 在 文件 系统 和 
stop on shutdown < 关闭 时 停止 程序 
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将 stdin 和 st respawn < 一 在 程序 月 演 时 重启 程序 
derr 输 出 到 / console log 
var/log/upst ， 
art/yourapp env NODE_ ENV=production 为 程序 设 定 必 要 
09 的 环境 变量 
exec /usry/Din/node /path/to/server, J]s 指定 执行 程 
序 的 命令 


这 个 配置 可 以 保证 你 的 进程 在 服务 器 重启 , 甚至 是 在 它 意 外 朋 演 之 后 还 能 运行 起 来 。 程序 生 
成 的 所 有 输出 会 发 送 到 /var/log/upstart/hellonode.log 中 ， 并 且 Upstart 会 带 你 管理 日 志 的 循环 使 用 。 

Upstart 配 置 文件 已 经 创建 好 了 ， 你 可 以 用 下 面 的 命令 启动 程序 : 

sudo service hellonode 

如 果 程 序 启动 成 功 ， 你 会 看 到 下 面 这 种 输出 : 

hellonode start/running, process 6770 


Upstart 的 可 配置 性 很 强 。 请 参考 在 线 cookbook ( http://upstart.ubuntu.com/cookbook/ ) 查看 所 
有 可 用 选项 。 








Upstart 和 重生 
当 使 用 了 respawn 选 项 时 ， 在 程序 衣 溃 时 ，Upstart 默 认 会 一 直 重新 加 载 你 的 程序 ， 除 非 它 
在 $ 秒 之 内 重启 了 10 次 。 你 可 以 用 respawn 1imit COUNT INTERVAL 人 选项 修改 这 一 限制 ， 其 
中 COUNT 是 在 INTERVAL 之 内 的 次 数 ， 而 INTERVAL 是 指定 的 秒 数 。 比 如 说 你 想 限 定 为 5 秒 内 20 
次 ， 则 配置 为 : 


respawn 
respawn limit 20 5 


如 果 你 的 程序 在 $ 秒 内 重新 加 载 了 10 次 (默认 限制 )， 通 常 是 因为 在 代码 或 配置 中 有 错误 ， 
并 且 它 永远 不 能 成 功 启 动 。 在 达到 限定 值 后 , Upstart 会 停止 启动 尝试 , 以 便 为 其 他 进程 节省 资源 。 
你 还 应 该 在 Upstart 之 外 做 健康 检查 ， 可 以 通过 email 或 其 他 快捷 通信 方式 向 开发 团队 发 出 
告 。 对 Web 程 序 而 言 ， 健 康 检 查 只 需 访 问 网 站 ， 看 能 否 得 到 有 效 的 响应 。 你 可 以 用 自己 的 方 
， 或 者 用 Monit (http://mmonit.com/monit/ ) 或 Zabbix ( www.zabbix.com/ ) 之 类 的 工具 完成 这 


效 
法 
项 任务 。 





现在 你 已 经 知道 了 ,无 论 朋 省 还 是 服务 融 重 局 ， 都 有 办 法 保证 程序 的 运行 , 接 下 来 要 解决 的 
目 然 是 性 能 问题 。Node 的 集群 API 可 以 玫 到 我 们 。 


12.3.2 ”集群 API:， 利用 多 核 的 优势 
现代 的 计算 机 CPU 大 多 数 都 是 多 核 的 ， 但 单个 Node 进 程 在 运行 时 只 能 使 用 其 中 的 一 个 内 核 。 
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如 条 你 想 让 Node 程 序 最 大 限度 地 利用 服务 带 , 可 以 在 不 同 的 TCP/PP 闯 口上 局 动 多 个 程序 实例 , 并 
通过 负载 均衡 把 Web 流 量 分 发 到 不 同 的 实例 上 ， 但 这 种 方式 设置 起 来 很 费劲 。 

为 了 让 单个 程序 使 用 多 核实 现 起 来 更 容易 ，Node 增 加 了 集群 ( cluster ) API。 借 助 这 个 APT， 
程序 可 以 在 不 同 的 内 核 上 同时 运行 多 个 “工人 ,每 个 “工人 ”做 的 都 是 相同 的 事情 ， 并 且 是 在 

















同一 个 TCP/P 库 口上 返回 啊 应 。 图 12-4 展 示 了 如 何 用 集群 API 在 一 个 四 核 处 理 可 上 组 织 应 用 程序 





的 处 理工 作 。 











CPU core | CPU core | CPU core 


























图 12-4 ”一 个 主 进程 在 四 核 处 理 副 上 党 衍 出 三 个 工人 
下 面 的 代码 清单 自动 繁衍 一 个 主 进程 ， 并 且 每 个 内 核 一 个 工人 。 
代码 清单 12-2 ” ”Node 集群 API 演 示 
Var cluster = require('cluster'); 


pm | 口 忆 
var NEED = require( "heto'):; 确定 服务 器 
Var numCPUs = require('os') .cpus().length; 的 内 核 数 





if (cluster.isMaster) { 


for (var i = 0; i < numCpPUs; i++) { | 每 个 内 核 创建 


cluster.fork(); 一 个 fork 

} 

cluster.on('exit', function(worker, code, signal) { 
console.log('Worker ' + worker.process.pid + ' died.'); 

I 

} else { 定义 每 个 工 

http.: Server (function(rery, Tes). | 人 的 工作 
res.writeHead (200);， 
res.end('I am a worker running in process ' + process.pid); 


}).listen(8000); 
} 


因为 主 进 程 和 工人 运行 在 各 目的 操作 系统 进程 内 (这样 它们 才 有 可 能 运行 在 各 日 的 内 核 
上 )， 所 以 它们 不 能 通过 全 局 变量 共 圣 状态 。 但 集群 API 提 供 了 一 种 让 主 进 程 和 工人 彼此 相互 通 
信 的 办 法 。 

下 面 的 代码 清单 是 一 个 在 主 进程 和 工人 之 间 传 送 消息 的 例子 。 主 进程 会 持 有 所 有 请 求 的 计 
数 ， 并 且 只 要 有 工人 报告 处 理 了 请 求 ， 它 就 会 被 传递 给 所 有 工人 。 
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代码 清单 12-3 Node 集群 API 演 示 


var Cluster = require('cluster'); 

Var http = regquire('http'); 

var numCPUs = require('os'} .cpus() .length; 
Var workers = {}; 

Var requests = 0; 


It (cluster.isMaster) { 


for (var i1 = 0; 工 < numCPUs; i++) { 
workers[i] = cluster.fork(); 
II 大 IF 未 
(function (i) { i 
workers[i].on('message', function(message) { 人 的 消息 
if (message.cmd == 'incrementRequestTotal') { 
requests++; 区 a 
的 号 |- 寺 ， ， 将 新 的 请 求 总 类 
增加 请 for (Var J © 0 9 < numCPUs> 可 t+ 4 ee 
万 把 类 ， 
求 总 数 workers[j].sendl(t 发 送 给 所 有 工人 
cma : 'updateOfRequestTotal', 
requests: requests 
}); 
} 
} 
ey ee 
1 工人 的 什 
}) (1); 人 的 人 
} 
cluster.on('exit', function(worker, code, signal) { 
console.log('Worker ' + worker.process.pid + ' died.'); 
本 本 
} else { 网 
process.on('message', function(message) { 进程 的 消息 
if (message.cmd == 'updateOfRequestTotal') { 
requests = message.requests; 用 主 进程 的 消息 
) 更 新 请 求 计数 
J 
http.Server (function(req, res) { 
res.writeHead(200);， 
res.end('Worker in process ' + process.pid 
十 says cluster has responded to + requests 让 主 进程 知道 请 求 
0 总 数 应 该 增加 了 
process.send({cmd: 'incrementRequestTotal'}); 


}).listen(8000).， 
} 


使 用 Node 的 集群 API 可 以 轻松 创建 出 能 发 挥 现代 硬件 优势 的 程序 。 


12.3.3 静态 文件 及 代理 


尽管 Node 在 提供 动态 内 容 服务 时 很 高 效 , 但 在 提供 图 片 、CSS 样 式 表 或 客户 端 JavaScript 等 静 
态 文 件 服 务 时 并 不 是 最 有 效 的 办 法 。 通 过 HTTP 提 供 毅 态 文 件 的 服务 应 该 交 给 专门 针对 这 个 特定 
任务 优化 过 的 特定 软件 项 目 ， 因 为 它们 多 年 以 来 主要 专注 于 这 项 任务 。 

Nginx ( http://nginx.org/en/ ) 是 一 个 专门 针对 静态 文件 服务 做 过 优化 的 开源 Web 服 务 硕 , 很 容 
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易 设 置 成 跟 Node 一 起 提供 那些 文件 服务 。 在 典型 的 Nginx/Node 配 置 中 ， 一 般 由 Nginx 先 处 理 所 有 
Web 请 求 ， 青 将 非 静 态 文 件 的 请 求 转 给 Node。 这 种 配置 如 图 12-5 所 示 。 


Web 训 览 器 





请 求 咯 应 








文件 请 求 | 


契 百 
是 请 求 静态 文件 吗 ? Node 应 用 






| Node 啊 应 




















Te 
文件 系统 





图 12-5 ”你 可 以 用 Nginx 作 为 代理 将 静态 资源 快速 返回 给 Web 客 户 端 
下 面 的 配置 代码 实现 了 这 种 设置 ， 它 应 该 被 放 在 Nginx 配 置 文件 的 http 部 分 。 按 照 传统 ， 这 








个 配置 文件 应 该 是 Linux /etc 目 录 下 的 /etc/nginx/nginx.conf 文 件 。 


代码 清单 12-4 用 Nginx 做 Node.js 的 代理 并 提供 静态 文件 服务 的 配置 文件 


http { 
upstream my_node app { Node 程 序 的 IP 地 址 
server 127.0.0.1:8000; 和 端口 
} 
I 代理 接收 请 求 
listen 80; 的 端口 


server name localhost domain.com; 
access_log /var/log/nginx/my_node app.1o0og9g; 


location ~ /static/ { 处 理 URL 路 径 以 
root /home/node/my_node_app; to 的 六 
if (!-f Sregquest filename) { 件 请 求 

return 404; 
} 
. 定义 由 代理 响应 
LoeBtion 7 4 的 URL 路 径 


proxy_pass http://my_node_app; 
Proxy_ redirect off; 


proxy_set_ header X-Real-IPp sremote _ addr:; 

proxy_ set header X-Forwarded-For Sproxy add x forwarded for; 
Proxy set header Host Shttp host; 

proxy_set header X-NgqinX-Proxy true:; 
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} 
} 
} 


用 Nginx 处 理 你 的 静态 Web 资 源 ， 你 可 以 确信 Node 在 做 它 最 擅长 的 事情 。 











12.4 ”小 结 


本 草 介 绍 了 几 种 可 选择 的 Node 牡 主 ， 包 括 专 供 Node 的 御 主 、 专 用 服务 锅 、 虚 拟 私 有 服务 天 
以 及 云 主机 。 每 种 选择 都 有 各 目 适 用 的 场景 。 

在 你 准备 部 署 的 Node 程 序 受众 有 限时 ， 可 以 用 Forever 管 理 你 的 程序 ， 启 动 运行 迅速 。 而 对 
于 长 期 部 署 而 言 ， 你 可 能 想 用 Upstart 实 现 程 序 启动 和 停止 的 自动 化 。 

为 了 充分 利用 服务 器 的 资源 ， 你 可 以 借助 Node 的 集群 API 同 时 在 多 个 内 核 上 运行 程序 的 实 
例 。 如 果 你 的 Web 程 序 需 要 提供 图 片 和 和 PDF 文档 之 类 的 静态 资源 服务 ， 可 能 还 想 让 Nginx 给 你 的 
Node 程 序 做 代理 服务 帮 。 

你 对 Node Web 程 序 的 里 里 外 外 都 有 了 良好 的 认识 ， 可 以 去 看 看 Node 还 能 做 哪些 事情 了 。 我 
们 会 在 下 一 章 里 介绍 一 下 Node 的 其 他 用 途 : 从 构建 命令 行 工 具 到 从 网 站 上 扒 数 据 无 所 不 包 。 
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本 章 内 容 

口 用 Socket.IO 实 现实 时 的 路 浏览 大 通信 
口 实现 TCP/ 下 网 络 

口 用 Node 的 API 跟 操作 系统 交互 

口 开发 和 使 用 命令 行 工 具 


由 于 Node 的 异步 天 性 ， 它 很 适合 用 来 执行 那些 在 同步 环境 中 比较 困难 或 效率 低下 的 IO 密集 
型 任务 .本 书 大 部 分 内 容 都 在 讨论 HTTP 程 序 , 但 其 他 程序 是 什么 情况 呢 ? Node 还 能 用 来 做 什么 ? 

真相 是 Node 不 仅仅 是 为 HTTP 而 生 的 , 它 还 可 以 处 理 各 种 通用 的 VO。 也 就 是 说 实际 上 你 可 以 
用 Node 构 建 各 种 程序 ， 比 如 命令 行程 序 ， 系 统管 理 脚本 ， 以 及 实时 的 Web 应 用 程序 。 

本 章 会 教 你 构建 超越 传统 HITTP 服 务 器 模型 的 实时 Web 服 务 器 。 还 会 向 你 介绍 一 些 其 他 的 
Node API， 可 以 用 来 创建 其 他 类 型 程序 ， 比 如 TCP 服 务 器 或 命令 行程 序 。 

我 们 会 从 Socket.IO 开 始 ， 它 能 实现 浏览 器 和 服务 器 之 间 的 实时 通讯 。 


13.1 Socket.1O 


Socket.IO ( http://socket.io ) 可 以 说 是 Node 社 区 中 最 著名 的 模块 。 那 些 对 创建 实时 Web 程 序 感 
兴趣 ,但 从 没 听 说 过 Node 的 人 ,一 般 迟 早 会 听 说 SocketIO , 然后 他 们 会 被 它 带 到 Node 中 。SocketIO 
人 允许 你 用 服务 闫 和 客户 端 之 间 的 双 回 通讯 通道 编写 实时 的 Web 程 序 。 

最 简单 的 ，Socket.IO 有 一 个 API 跟 WebSocket API ( http://www.websocket.org ) 很 像 ， 但 给 那 
些 还 没有 这 种 特性 的 较 老 浏览 希 准 备 了 一 个 内 置 的 备 选 方案 。Socket.IO 还 为 广播 、 匈 失 性 消息 ， 
以 及 很 多 特性 提供 了 便利 的 API。 这 些 特性 使 得 Socket.IO 在 基于 Web 的 浏览 器 游戏 、 聊 天 程序 和 
流 媒体 应 用 中 非常 流行 。 

HTTP 是 无 状态 协议 ， 也 就 是 说 客户 端 只 能 辐 服 务 需 发 起 单个 的 、 短 命 的 请 求 ， 并 且 服 务 天 
也 没有 真正 意义 上 的 已 连接 的 或 断 开 连接 的 用 户 。 这 些 限制 推动 了 WebSocket 协 议 的 标准 化 工作 ， 
为 浏览 硕 指 定 了 一 种 维持 到 服务 硕 的 全 双 工 连接 的 办 法 ， 人 允许 双方 同时 发 送 和 接受 数据 。 信 助 
WebSocket API 可 以 创建 一 种 全 新 的 ， 利 用 客户 端 和 服务 器 之 间 的 实时 通讯 的 Web 程 序 。 

WebSocket 协 议 的 问题 是 它 还 没 最终 定 稿 , 尽 省 有 些 浏 览 瘟 已 经 开始 疙 备 WebSocket 了, 但 外 
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面 还 有 很 多 老 版 浏览 硕 ， 特 别 是 下。 为 了 解决 这 个 问题 ， 当 浏览 大 可 以 使 用 WebSocket 时 ， 
Socket.IO 就 使 用 它 , 而 在 老 版 的 浏览 硕 中 , 则 借助 其 他 特定 的 浏览 器 技巧 模拟 WebSocket 的 行为 。 

本 节 会 用 Socket.IO 构 建 两 个 样本 程序 : 

D 一 个 非常 和 测 单 的 Socket.IO 程 序 ， 会 把 服务 大 上 的 时 间 推 送 给 所 有 连接 上 来 的 客户 痊 ; 

口 一 个 在 CSS 文 件 被 编辑 后 触发 页 面 刷 新 的 Socket.IO 程 序 。 

在 你 构建 完 示例 程序 之 后 ， 我 们 会 简单 地 重 温 一 下 第 4 章 的 上 传 进 度 程序 ， 再 展示 几 种 
Socket.IO 的 用 法 。 接 下 来 我 们 先 从 基础 知识 开始 吧 。 








13.1.1 创建 一 个 最 小 的 Socket.IO 程 序 


假定 你 想 构建 一 个 小 型 的 Web 程 序 ， 用 服务 顺 端 的 UTC 时 间 持 续 更 新 浏览 锅 。 这 样 的 程序 可 
以 帮 我 们 找 出 客户 端 和 服务 需 端 的 时 间 差 异 。 你 先 想 想 用 之 前 学 的 http 模 块 或 框架 如 何 构建 这 
个 程序 。 尽 管用 长 轮 询 之 类 的 技术 也 有 可 能 做 出 能 用 的 东西 ， 但 Socket.IO 有 更 简洁 的 接口 。 用 
Socket.IO 大 概 是 你 能 找到 的 最 简单 的 实现 办 法 。 

我 们 先 从 安装 SocketIO 开 始 ， 执 行 下 面 这 条 npm 命 令 : 

npm install socket.io 


下 面 的 清单 给 出 了 服务 硕 端 代码 ， 先 把 这 个 文件 存 下 来 ， 等 你 有 客户 端 代 人 码 的 时 候 可 以 试 一 下 。 
代码 清单 13-1 用 目 己 的 时 间 更 新 客户 端的 Socket.IO 服 务 需 




















var app = Tedqulrel('http') .createServer (handler); 

Var 10 = TeGqulre(' Socket .1Io').1L1stenl(appP): 、 - 

i “| 将 普通 的 HTTP 服 务 器 逢 级 为 

V 二 Ul 7 口 口 
Socket.IO 服 务 器 


Var html = fs.readFileSync('index.html', 'utf8').; 
_ HTTP 服 务 器 代码 总 会 提供 index.html 
function handler (reqgq, res) { 
res.setHeader('Content-Type', 'text/html'); 
res.setHeader('Content-Length', Buffer.byteLength(html, 'utf8')).; 
res.endl(html).; 
} 


i | 取得 当前 时 间 的 UTC 表示 
Var now = new Date() .toUTCStrInG ( ) ; 
10.SocKkets.sendq(now) ; 

将 时 间 发 送 给 所 有 连接 上 来 的 客户 端 


setInterval (tick, 1000); ee 、， 
每 秒 运行 一 次 tick 函 数 


app.listen(8080); 

如 你 所 见 ，SocketIO 将 需要 额外 添加 到 基本 HTTP 服 务 器 上 所 需 的 代码 量 降 到 了 最 低 。 为 了 
在 服务 项 和 客户 端 之 间 实 现实 时 消息 ， 跟 io 变量 〈 它 就 是 你 的 SocketIO 服 务 需 实例 ) 有 关 的 代码 
只 有 两 行 。 这 个 时 钟 服务 器 每 隔 一 秒 调用 一 次 tick() 函数 ， 把 服务 器 的 时 间 发 给 所 有 连接 上 来 
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的 客户 妆 。 
服务 带 代 码 和 完 把 index.html 文 件 读 到 内 存 中 ， 克 ® 古 你 马上 要 实现 的 那个 文件 。 下 面 的 代码 清 
单 中 是 这 个 程序 的 客户 闻 代 人 码 。 


代码 清单 13-2 ”显示 服务 豆 广 播 时 间 的 Socket.IO 客 户 端 


<1DOCTYEE html> 








<html> 
<head> 
<script type="text/javascript" src="/socket.1i0/socket.10.]Ss"> 
</script> 
用 服务 器 时 eeripot Cvoe="text/ I avasdGriot'> 连接 Socket.IO 
间 更 新 time var socket = io.connect(); 服务 器 
span 元 素 socket.on('message', function (time) { 收 到 message 事 件 
| > document .getElementById('time') .innerHTML = time; | 时 ， 服 务 器 已 经 把 
时 间 发 送 过 来 了 
}1}; 
</Sscript> 
</head> 
<body>Current server time is: <b><span id="time'"></span></b> 
</body> 
</html> 


试 一 下 

服务 颖 准备 就 红 了 。 用 node clock-server .js 启动 它 ， 你 应 该 能 看 到 日 志 输 出 “info - 
socket.io started”。 这 就 意味 这 Socket.IO 设 置 好 了 了， 准备 接受 连接 ， 所 以 你 可 以 打开 浏览 兹 访问 
URL http:/localhost:8080/。 运 气 好 的 话 ， 你 会 看 到 如 图 13-1 中 所 示 的 问候 。 时 间 每 隔 一 秒 就 会 用 
服务 套 发 来 的 消息 更 新 。 打 开 另 一 个 浏览 硕 同 时 访问 相同 的 URL， 你 会 看 到 它们 的 值 同 步 更 新 。 


socket.io started 

served static content /socket.io0.]s 
client authorized 

el A A A 
setting request GET /socket.io/1/websocket/71136325342260494 € 











@OA "localhost:8080 


G | © localhost:8080 


Current server time is: Thu, 19 Jan 2012 07:43:27 GMT 


set heartbeat interval for client 71136325342260494 
client authorized for 

websocket writing 1:: 

websocket Writing 3:::Thu, 19 Jan 2012 07:40:88 GMT 
websocket Writing 3:::Thu, 19 Jan 2012 07:40:09 GMT 
websocket Writing 3:::Thu, 19 Jan 2012 07140:10 GMT 
websocket writing 3:::Thu, 19 Jan 2012 07:140:11 GMT 
websocket Writing 3:::Thu, 19 Jan 2012 07:40:12 GMT 
websocket Writing 3:::Thu, 19 Jan 2012 87:40:13 GMT 





图 13-1 运行 在 终端 窗口 中 的 时 钟 服务 费 和 在 浏览 旨 中 连接 到 服务 器 上 的 客户 端 
就 这 样 ， 只 用 几 行 代码 就 实现 了 客户 端 和 服务 硕 端 的 实时 通讯 ， 感 谢 Socket.IO。 
Socket.IO 发 送 消息 的 其 他 方式 ”给 所 有 连接 上 了 的 socket 发 送 消 息 只 是 Socket.IO 让 
你 给 连接 上 来 的 用 户 进 行 交 互 的 办 法 之 一 。 你 还 可 以 给 单个 socket 发 送 消 息 ， 向 除 某 个 
socket 之 外 的 所 有 socket 广 播 , 发送 易 失 性 (可 选 ) 消 息 , 等 等 。 你 一 定 要 看 一 看 Socket.IO 
的 文档 了 解 更 多 信息 ( http://socket.io/#how-to-use )。 
现在 你 已 经 认识 到 使 用 Socket.IO 事 情 可 能 有 多 简单 了 , 接 下 来 我 们 再 看 一 个 例子 , 看 看 服务 
礁 发 送 的 事件 如 何 大 到 开发 人 员 。 
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13.1.2 ”用 Socket.IO 触 发 页 面 和 CSS 的 重新 加 载 


我 们 快速 了 解 一 下 Web 页 面 设 计 师 的 经 典 工作 流程 : 

(1) 在 多 个 浏览 本 中 打开 页 面 ; 

(2) 寻找 页 面 上 需要 调整 的 样式 ; 

(3) 修改 一 或 多 个 样式 表 ; 

(4) 手动 刷新 浏览 锅 中 的 页 面 ; 

(5) 回 到 第 2 步 。 

其 中 的 第 四 步 应 该 日 动 执 行 ， 即 设计 师 到 每 个 浏览 瘟 中 手动 点 击 刷 新 按钮 那 一 步 。 当 设计 师 
需要 在 不 同 的 电脑 和 各 种 移动 设备 上 测试 不 同 的 浏览 锅 时 ， 这 个 特别 耗 时 间 。 

但 如 条 你 能 完全 去 反手 动 刷新 这 一 步 呢 ? 想象 一 人 下 ， 当 你 在 文本 编辑 硕 中 保存 样式 表 时 ， 所 有 
打开 了 那个 页 面 的 浏览 需 都 会 自动 重新 加 载 这 个 CSS 样 式 表 。 这 会 帮 开 发 人 员 和 设计 师 节 省 大 量 时 
间 , SocketJO 跟 Node 的 fs .watchFile 和 fs .watch 捕 数 配 合 , 只 需 几 行 代 人 码 束 能 让 这 个 想法 变 成 现实 。 

我 们 在 这 个 例子 中 会 用 fs .watchFile() 代 和 奉 比 较 新 的 fs.watch() ， 因 为 我 们 要 确保 这 上 段 
代码 在 所 有 平台 上 的 表现 都 保持 一 致 ， 但 后 面 我 们 会 更 深入 地 探讨 fs .watch () 的 表现 。 

fs.watchfile() 与 fs.watch() Nodejs 中 有 两 个 监测 文件 的 API: fs .watchFile() 

(http:/mng.bz/v6dA ) 更 耗资 源 ,但 它 更 可 靠 , 而 且 是 跨 平 台 的 ,fs .watch()( http://mng. 

bz/SKSC ) 针 对 每 个 平台 做 了 高 度 优化 ,但 在 每 个 平台 上 的 表现 是 不 同 的 ,我 们 会 在 13.3.2 

节 更 详细 地 介绍 这 些 了 滨 数 。 

在 这 个 例子 中 ， 我 们 会 让 Express 框 架 和 Socket.IO 结 合 在 一 起 。 它 们 的 配合 可 以 做 到 天 衣 无 
颖 , 就 像 亲 面 那个 例 了 于 中 普通 的 ht tp. Server 一 样 o 

我 们 先 来 看 一 下 完整 的 服务 融 代 人 码 。 如 采 你 最 后 想 运 行 一 下 这 个 例子 ， 把 下 面 的 代码 存 为 


Watch-server.]S。 


代码 清单 13-3 ”在 文件 改变 时 除非 事件 的 Express/Socket.IO 服 务 需 





























var fs = require('fs'); 

Var url = require('url'); 

var http = require('http'); 

var path = require('path'); 

Var express = require('express').; 创建 Express 服 务 器 

var app = exXxpress ( ) ; 

var server = http.createServer (app); 包装 HTTP 服 务 器 创建 
var io = require('socket.io') .listen(server).; Socket.1O0 实 例 

var root = _ dirname,; 


app.use (function (req, res, next) { 








sale 2 ori .parsetzea url) .pathname; | 注册 由 statie() | 用 中 间 件 开始 监 Em 
ne " 中 间 件 发 射 的 由 static 中 国 件 
Var mode = 'stylesheet'; , i 
if (file[file.length - 1] == '/') { static 事 件 返回 的 文件 
file += 'index.html'; 
mode = 'reload'; 


. 
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createWatcher (file, mode).; 确定 要 提供 的 文件 名 并 调 
}); 用 createWwatcher () 
next ().; 
站 将 服务 器 设置 为 基本 的 静 
app.use (express.static(root)); 态 文件 服务 器 
var watchers = {}; 


保存 被 监测 的 活动 文件 
function createWatcher (file, event) { 清单 
var absolute = path.join(root, file) 


1 


if (watchers[absolute]) { 
return,; 

} ee 

_ 开始 监测 文件 发 生 的 所 
有 


fs.watchFile(absolute, function (curr, prev) { 变化 


if (curr.mtime !== prev.mtime) { 检查 mtime (最 后 修改 时 间 ) 是 否 有 
lio.sockets.emit (event, file); 变化 ; 如 果 变 了 , 激发 Socket.IO 事 件 
， 
yo 
watchers[absolute] = true; | 将 文件 标记 为 监测 对 象 
， 


server.listen(8080); 

你 有 了 功能 完备 的 静态 文件 服务 硕 ， 可 以 准备 好 用 Socket.IO 通 过 网 络 癌 客户 闪 激 发 reloadq 
和 stylesheet 事 件 。 

现在 我 们 来 看 一 下 基本 的 客户 端 代 码 。 把 这 个 保存 为 index.html， 当 你 再 一 次 局 动 服 务 表 后 ， 
访问 根 路 径 时 就 能 得 到 这 个 文件 了 。 


代码 清单 13-4” 收 到 服务 冀 问 的 事件 后 重新 加 载 样 式 表 的 客户 端 代 人 码 
<IDOCTYPE html> 
<html> 
<head> 

<title>Socket.I0 dynamically reloading CSS stylesheets</title> 
<]ink rel="stylesheet'" type="text/css" href='"/header.css" /> 
<link rel="stylesheet" type='"text/css" href="/styles.css'" /> 
<Script type="text/jJavascript" src="/socket.io/socket.1i0o0.]s"> 








</Sscript> 
<sScript type="text/jJavascript"> 
window.oniload = function () { 
var socket = io.connect().; < 一 ”连接 服务 器 
socket.on('reload', function () { 
立 名 台 > < 二 人 
window.location.reload(); | 接收 服务 器 发 来 的 reload 事 件 
}); 
socket.on('stylesheet', function (sheet) 1{ a . 
Var link = document.createElement ('1]ink'); 接收 服务 器 发 来 的 
Var head = document .getElementsByTagName ('head') [0]; stylesheet 事 件 
lJ]ink.setAttribute('rel', 'stylesheet'); 
link.setAttribute('type', 'text/css'); 


link.setAttribute('href', sheet).; 
head.appendChild (link).; 
}); 
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} 
</sScript> 
</head> 
<body> 
<hi>This is our Awesome Webpage!</hl1l> 
<div id="body"> 
<p>If this file (<code>index.html</code>) 1s edited, then the 
Server will send a message to the browser using Socket .IO telling 
it to refresh the page.</p> 





<p>If either of the stylesheets (<code>header.css</code> or 
<cCode>styles.css</code>) are edited, then the server will send a 
message to the browser using Socket .IO telling it to dynamically 
reload the CSS, without refreshing the page.</p> 





</div> 
<div id="event-log"></div> 
</body> 
</html> 
试 一 下 
你 还 需要 创建 两 个 CSS 文 件 这 个 才能 用 ， 因 为 在 加 载 index.html 文 件 时 它 会 加 载 这 两 个 样 
式 表 。 
你 已 经 有 了 服务 器 人 代码， 浏览 器 用 的 index.html 文 件 和 和 CSS 样式 表 ， 可 以 试 一 下 了 。 启 动 服 
务 人 大: 


S node Watch-SserVvetr .]S 

服务 磊 启 动 后 , 打开 浏览 豆 访 问 http:Wlocalhost:8080, 浏览 大 会 收 到 简单 的 HTML 页 面 并 演 染 
它 。 现 在 试 着 修改 其 中 一 个 CSS 文 件 〈 可 能 是 调整 body 标 签 的 背景 色 )， 你 会 杀 眼 看 到 浏览 冀 重 
新 加 载 了 样式 表 ， 其 至 连 页 面 都 没有 刷新 。 试 者 同时 在 多 个 浏览 带 中 打开 页 面 

这 个 例子 中 的 reload 和 stylesheet 是 你 在 程序 中 定义 的 定制 事件 ， 它们 不 是 Socket10 的 
API。, 这 阐明 了 如 何 把 socket 对 和 象 当 作 双 同 EventEmitter，Socket.IO0 会 通过 网 络 帮 你 传输 激发 
的 事件 。 














13.1.3” Socket.I0 的 其 他 用 法 


你 知道 的 ， ee 但 随 春 浏览 需 技 术 的 发 展 ， 比 如 
WebSocket， 以 及 像 Socket.I0 这 样 的 模块 ， 这 一 限制 已 经 被 解除 了 ， 它 们 为 之 前 不 可 能 出 现在 浏 
览 器 中 的 所 有 新 型 程序 打开 了 一 扇 大 门 。 

我 们 在 第 4 章 曾 经 讲 过 ， 用 Socket.IO 把 上 传 进 度 事件 传 给 浏览 带 让 用 户 看 应 该 会 很 梭 。 用 一 
个 定制 的 progress 事 件 应 该 就 可 以 很 好 地 完成 这 个 任务 : 





. 更 新 4.4.3 节 的 例子 
form.on('progress', function(bytesRecelived, bytesExpected) { 


Var percent = Math.floor(bytesReceived / bytesExpected * 100).;， 


socket.emit('progress', { percent: percent }); 


| 用 Socket.IO 传 递 已 上 传 的 百分比 
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为 了 实现 这 个 消息 传递 , 你 要 能 访问 到 浏览 硕 上 传 文件 的 socket 实 例 。 这 超出 了 本 书 的 范围 ， 
但 网 上 有 可 以 帮 你 解决 这 个 问题 的 资源 。 建 议 初 学 者 看 看 Daniel Baulig 发 表 在 他 的 博客 上 的 文章 
“socket.io 和 Express: 把 它们 捆绑 到 一 起 ”，www.danielbaulig.de/socket-ioexpress。 

Socket.IO 具 有 划时代 的 意义。 就 像 之 前 说 的 ， 对 开发 实时 Web 程 序 感 兴趣 的 开发 人 员 经 第 是 
先 听 说 SocketIO ， 然 后 才 知 道 有 Node.js 一 一 足 可 见 Socket.IO 的 影响 力 和 重要 性 。 一 直 以 来 ， 它 
都 得 到 了 Web 洲 戏 社区 的 牵引 ， 并 且 被 用 在 了 比 我 们 想象 中 更 多 的 创意 游戏 和 应 用 程序 中 。 它 在 
Node.js 竞 赛 中 的 出 镜 率 也 很 高 ， 比 如 在 Node Knockout 中 ( http://nodeknockout.com )。 你 会 用 它 编 
写 出 什么 精彩 绝伦 的 作品 呢 ? 

















13.2 ”深入 TCP/IP 网 络 


Node 非 常 适合 做 网 络 程序 ， 因 为 它们 一 般 都 会 涉及 到 大 量 IO。 除 了 你 已 经 学 了 很 多 东西 的 
HTTP 服 务 硕 ，Node 还 可 以 文 持 任何 以 TCP 为 基础 的 网 络 程序 。 比 如 说 ，Email 服 务 硕 ， 文 件 服务 
硕 ， 或 者 代理 服务 融 都 可 以 以 Node 为 平台 编写 ， 并 且 它 还 可 以 作为 这 些 服务 的 客户 端 。Node 提 
供 了 一 些 工 具 ， 可 以 帮 你 编写 出 优质 高 效 的 VO 应 用 程序 ， 我 们 这 一 市 就 会 介绍 它们 。 

有 些 网 络 协议 要 该 取 字 节 一 级 的 值 char、int、float， 以 及 其 他 包含 二 进 制 数据 的 数 
据 类 型 ,但 JavaScript 没 有 任何 原生 的 二 进 制 数据 类 型 ,最 接近 的 东西 也 是 用 字符 串 状 狂 黔 出 来 的 。 
Node 勇 挑 重担 ， 实 现 了 它 自己 的 Buffer 数 据 类 型 ， 这 是 一 块 长 度 固 定 的 二 进 制 数据 ， 有 了 它 在 
实现 其 他 协议 时 就 可 以 访问 底层 二 进 制 数据 了 。 

本 六 会 介绍 下 面 这 些 主 题 : 

口 使 用 缓冲 区 和 二 进 制 数据 ; 

口 创建 TCP 服 务 器 ; 

口 创建 TCP 客 户 端 。 

我 们 先 深入 探讨 一 下 Node 如 何 处 理 二 进 制 数 据 。 


13.2.1 ”处 理 缓冲 区 和 二 进 制 数 据 


Buffer 是 Node 给 开发 者 准备 的 特殊 数据 类 型 。 它 像 是 一 块 长 度 固 定 的 原始 二 进 制 数据 板 坏 。 
你 可 以 把 缓冲 区 看 做 C 中 的 malloc () 函数 或 C++ 中 的 关键 字 new。 绥 冲 区 既 快 又 轻 ， 广 泛 应 用 在 
Node 的 核心 API 中 。 比 如 说 ， 所 有 的 Stream 类 返回 的 data 事 件 中 默认 都 会 包含 它们 。 

在 Node 中 全 局 都 可 以 访问 Buffezr 构 造 衣 ， 以 或 励 你 把 它 当 做 对 筑 规 J avaScript 数 据 类 型 的 扩 - 
展 使 用 。 从 编程 的 角度 来 看 ,你 可 以 把 绥 冲 区 看 做 数组 ， 只 是 它们 的 大 小 是 固定 的 ,并且 只 能 存 
放 数 字 0 到 255。 因此 是 存放 二 进 制 数据 , 好 吧 , 一 切 值 的 理想 选择 。 因 为 缓冲 区 能 处 理 原始 字 节 ， 
所 以 你 可 以 用 它们 实现 任何 底层 的 协议 。 

文本 数据 与 二 进 制 数据 

假设 你 想 用 Buffer 在 内 存 中 存放 数值 121234869. Node 默 认 会 假定 你 想 在 缓冲 区 中 人 处理 基 于 
文本 的 数据 ， 所 以 当 你 把 字符 串 “121234869” 传 给 Buffer 的 构造 函数 时 ，Node 会 分 配 一 个 新 的 
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Buf fer 对 象 , 并 把 那个 字符 串 值 写 进 pe 


var b = new Buffer{({"121234869"); 





console.logtb.length); 
9 


console.1log{(b)}.; 
<Buftfer 31 32 31 32 33 34 38 36 39> 


这 个 例子 返回 的 是 一 个 9 学 市 的 Buffer。 这 是 因为 字符 串 是 用 默认 的 基于 文本 的 人 类 可 读 编 
人 码 (UTF-8 ) 写 到 Buffer 中 的 ， 这 样 字符 串 中 的 每 个 字符 都 会 用 一 个 字 节 表示 。 

Node 中 还 有 用 来 谈 写 二 进 制 〈 机 需 可 谈 ) 整 型 数据 的 辅助 男 数 。 在 你 实现 通过 网 络 发 送 原始 
数据 类 型 ( 比如 整 型 、 浮 点 型 、 双 整 型 等 等 ) 的 机 带 协 议 时 需要 它们 的 帮助。 因为 你 想 存储 本 例 
中 的 数值 ， 用 辅助 函数 writeInt32LE() 将 数值 121234869 作 为 机 器 可 读 的 二 进 制 整 型 (假定 是 
小 尾数 处 理 硕 ) 写 入 一 个 四 字 广 Buffer 中 可 能 效率 更 高 。 

Buffer 的 辅助 函数 还 有 一 些 ， 包 括 : 

D writeInt16LE() 用 于 较 小 的 整 型 值 ; 

口 writeUInt32LE() 用 于 无 符号 值 : 

口 writeInt32BE() 用 于 大 尾数 值 。 

此 外 还 有 很 多 , 所 以 如 果 你 对 它们 全 都 感 兴趣 , 一 定 得 看 看 Buffer 的 API 文 档 ( http://nodejs. 
org/docs/latest/api/buffer.html )。 

下 面 的 代码 用 二 进 制 辅 助 疯 数 wri teInt32LE 写 入 这 个 数值 : 


var b = new Buftfer!4).; 
pb.writeInt32LE{({121234869, 0)，: 
































console.log(b.length).; 
4 
console.log(b).: 

<Buftfer b5 es 39 U7> 


把 值 作为 二 进 制 整 型 而 不 是 文本 字符 串 存 在 内 存 中 ， 数 据 的 大 小 减 了 一 半 ， 从 9 个 子 市 楼 成 
了 4 个 。 图 13-2 对 这 两 个 绥 冲 区 进行 了 分 解 ， 并 基本 上 阐明 了 人 类 可 读 (文本 ) 协议 和 机 各 可 谈 
(二 进 制 ) 协议 之 间 的 差异 。 

不 管 你 处 理 的 是 哪 种 协议 ，Node 的 Buffer 类 都 能 应 对 正确 的 表示 形式 。 














字 市 的 字 布 顺序 术语 “ 字 节 顺序 ”是 指 在 多 个 字 节 序列 中 的 守节 顺序 。 当 字 市 
按 小 尾数 排序 时 ， 最 低 有 效 字 宙 (LSB ) 最 先 存 放 ， 字 节 序 列 按 从 右 向 左 的 顺序 读 取 。 
相反 ， 大 尾数 排序 最 先 存放 的 是 最 高 有 效 字 节 〈MSB )， 字 节 序 列 按 从 左 向 右 的 顺序 读 
取 。Nodejs 给 小 尾数 和 大 尾数 的 数据 类 型 提供 了 同样 的 辅助 函数 。 


是 时 候 学 以 致 用 了 ， 我 们 要 用 这 些 Buffer 对 象 创建 一 个 TCP 服 务 器 并 跟 它 交互 。 
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UTF-8 文 本 值 








16 进 制 值 31 | 32|31|32|33|34|38|36 | 39 
存放 字符 串 数据 的 Buffer 
二 进 制 整 型 值 
1 2 6 9 
16 进 制 值 b5 | e3 





存放 二 进 制 数 据 的 Buffer 
图 13-2 ”将 121234869 表 示 为 文本 字符 串 和 小 尾数 二 进 制 整 型 在 字 节 上 的 差异 





13.2.2 创建 TCP 服 务 器 


Node 的 核心 API 一 直 坚 持 走 底层 路 线 ， 只 对 外 提供 最 基本 的 模块 构建 基础 。 Node 的 http 模 块 
就 是 其 中 的 典范 ， 它 在 net 模 块 基础 之 上 实现 了 HTTP 协 议 。 其 他 协议 ， 比 如 email 用 的 SMTP 或 传 
输 文 件 用 的 FTP， 也 需要 以 net 为 基础 实现 ， 因 为 Node 的 核心 API 没 有 实现 任何 其 他 高 层 协议 。 

1. 写 数 据 

net 模 块 提供 了 一 个 原始 的 TCP/IP socket 接 口 ， 你 可 以 用 在 上 自己 的 程序 中 。 创 建 TCP 服 务 需 
的 API 跟 创建 HTTP 服 务 需 的 很 像 : 调用 net .createSserver () 并 给 它 传人 一 个 回调 冰 数 ， 每 建 
立 一 个 连接 都 会 调用 它 。 主 要 区 别 在 于 创建 TCP 服 务 需 时 ， 回 调 困 数 只 有 一 个 参数 ( 通常 命名 为 
socket )， 是 一 个 Socket 对 象 ， 而 创建 HTTP 服务 需 时 的 参数 是 req 和 res。 

Socket 类 ”在 Node 中 ，Ssocket 类 同时 用 在 net 模 块 的 客户 端 和 服务 器 端 。 它 是 
Sttream 的 子 类 ， 既 可 读 又 可 写 (双向 )，。 也 就 是 说 ， 当 有 输入 数据 要 从 socket 中 读 取 出 
来 时 它 会 发 出 data 事 件 ， 当 要 发 送 输 | () 和 end() 函数 。 

我 们 来 快速 浏览 一 个 基本 的 net .Server， 它 等 待 达 接 ， 连 上 后 调用 一 个 回调 函数 。 这 个 例 
子 中 的 回调 函数 只 是 问 socket 中 写 入 “Hello World!”， 然 后 an 接 : 


var net = requirel('net').; 














net.createServer(function (socket) { 
socket .write('Hello World!\r\n'); 
socket.end!(}); 

}) .listen(l1337); 

console.log('listening on port 1337'); 
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局 动 服务 天 测试 一 下 : 
$s node server.js 
listening on port 1337 


如 条 你 试 网 通过 浏览 锅 连 接 这 个 服务 硕 , 那 是 连 不 上 的 , 因为 这 个 服务 各 不 文 持 HTTP 协 议 ， 
只 是 原始 的 TCP。 要 连接 这 个 服务 右 并 看 到 它 发 回来 的 消息 ， 需 要 用 合适 的 TCP 客 户 问 连接 ， 比 
Unetcat (1) : 


$s netcat localhost 1337 
Hello World! 


棒 极 了 ! 再 用 telnet (1) 试 一 下 : 


$s telnet localhost 1337 

Tryijng 127.0.0.1... 

Connected to localhost. 

Escape character ls '^]'. 

Hello World! 

Connection closed by foreign host. 


telnet 通 常 运行 在 交互 模式 下 ， 所 以 它 还 会 输出 目 己 的 内 容 , 但 “Hello World!” 确 实在 连 
接 之 前 输出 出 来 了 ， 和 我 们 预期 的 一 样 。 

如 你 所 见 ， 将 数据 写 到 socket 中 很 容易 。 只 要 调用 write() ， 然 后 在 最 后 再 调用 endq() 。 在 
HTTP 服 务 器 中 ， 将 响应 写 回 到 客户 端的 是 res 对 象 的 API， 这 个 API 有 意 跟 它 相 匹配 。 

2. 读 取 数据 

服务 需 一 般 都 遵循 请 求 - 啊 应 范式 ， 客 户 端 连 上 后 马上 发 送 某 种 请 求 。 服 务 需 读 取 请 求 并 进 
行 处 理 , 然后 将 啊 应 写 回 到 socket 中 。HTTP 协 议 就 是 这 样 的 ， 大 部 分 其 他 网 络 协议 也 是 这 样 ， 所 
以 除了 要 知道 如 何 写 入 数据 ， 还 页 知道 如 何 读 取 数 据 。 

如 果 你 还 记得 如 何 从 HTTP regq 对 象 中 读 取 请 求 主体 , 那么 从 TCP socket 中 该 取 数 据 对 你 来 说 
就 是 小 末 一 碟 。 跟 可 读 取 的 Stream 接 口 一 样 , 你 只 需要 监 昕 data 事 件 , 这 个 事件 中 就 有 从 socket 





























中 读 出 来 的 数据 : 
socket.ont'data', function (data) { 
Console.1og{'got "data"', data), 


I 

socket 上 默认 没有 设 定编 码 ， 所 有 参数 qata 应 该 是 Buffer 的 实例 。 通常 这 就 是 你 想 要 的 (所 以 
是 默认 值 ), 但 你 可 以 调用 setEncoding () 国 数 , 计 参 数 data 变 成 被 解码 的 字符 串 而 不 是 缓冲 区 很 
方便 。 你 还 要 监听 enq 事 件 , 以 便 知 道 客 户 端 何 时 关闭 了 它们 那 一 端的 socket, 不 会 再 发 送 任何 数据 : 


socket.on{'end', function (1{ 











console.logl'socket has ended').: 


7 
你 可 以 迅速 写 出 一 个 TCP 客 户 端 ， 只 需 等 着 第 一 个 daata 事 件 ， 就 能 看 到 给 定 SSH 服 务 套 的 厂 
本 号 : 


var net = Tedculrel'net ' ) :; 








var Socket = net.connect (1{ host: process.argv[2|], port: 22 }}): 
socket.setEncoding('utf8'}).; 
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socket.once('data', function (chunk}) f{ 
Console.log{'SSH server version: %j', chunk.trim())}):;: 





socket.endt{)}.: 


}); 

试 一 下 吧 。 注意 ， 这 个 超级 简化 的 例子 假定 整个 版 本 字符 串 会 在 一 个 数据 块 中 过 来 。 大 多 数 
情况 下 这 都 没 问题 , 但 正确 的 做 法 应 该 是 缓冲 输入 数据 , 直到 见 到 字符 \n。 我 们 看 一 下 github.com 
SSH 服 务 需 用 的 是 什么 : 


$s node client.js github.com 
SSH server version: "SSH-2.0-OpenSsSsH 5.5P1 Debian-6+squeezZzel+github8" 














3. 用 socket .pipe() 连接 两 个 流 

把 pipe() (http:/mng.bz/tuyo ) 跟 可 读 或 可 写 的 Socket 对 象 联合 起 来 使 用 也 是 个 好 主意 。 实 
际 上 ， 如 末 你 要 写 一 个 简单 的 TCP 回 声 服 务 硕 ,把 所 有 发 给 它 的 东西 返回 给 客户 端 ,， 在 回调 冰 数 
里 用 一 行 代码 就 能 搞定 : 

socket .pipe (socket).: 

这 个 例子 用 一 行 代码 就 实现 了 IETF Echo 协议 (http://tools.ietf.org/rfc/rfe862.txt )， 但 更 重要 
的 是 它 曾 明了 pipe() 既 可 以 癌 socket 对 象 输入 ， 也 可 以 接受 socket 对 象 的 输出 。 当 然 ， 你 通常 会 
用 更 有 意义 的 stream 实 例 ， 比 如 文件 系统 或 gzip 流 。 

4. 处 理 不 干净 的 断 开 

关于 TCP 服 务 带 ， 最 后 要 说 的 一 点 是 你 应 该 能 预期 到 客户 问 断 开 连 接 却 没有 干净 地 关闭 
socket 的 情况 。 对 于 此 例 中 的 netcat (1) 而 言 ， 当 你 按 下 Ctrl-C 杀 挥 进程 ， 而 不 是 Ctrl-D 干 净 地 关 
闭 连 接 时 就 会 出 现 这 种 情况 。 为 了 检测 这 种 情况 ， 你 需要 监 昕 close 事 件 : 


socket.on{'close', function {) f{ 




















console.log{'client disconnected'); 


oe 

如 果 你 要 在 socket 源 开 后 打扫 战场 ， 应 该 在 close 事 件 中 完成 ,而 不 是 在 end 事 件 中 ， 因 为 如 
采 不 是 干净 的 关闭 连接 ， 不 会 激发 end 事 件 。 

5. 全 拼 到 一 起 

我 们 来 把 这 些 事件 拼 到 一 起 创建 一 个 简单 的 echo 服 务 器 , 并 在 出 现 各 种 事件 时 在 终端 窗口 中 
输出 日 志 。 服 务 帝 代码 如 下 所 示 : 


代码 清单 13-5 ”把 收 到 的 所 有 数据 返回 给 客户 痪 的 简单 TCP 服 务 从 


var net = TeGqulrel('net ') ，; 








net.createServer (function (socket) { 


console.log('socket connected!').; _ Ab 人 、 、 
dat 6 现 多 次 

socket.on('data', function (data) { ata 事 件 可 能 会 出 现 多 次 

console.log('"data" event', data); 
2 _ end 事 件 在 每 个 socket 上 只 会 出 现 一 次 
socket.on('end', function () { 

console.log('"end" event').; 
}); close 事 件 也 是 在 每 个 socket 
SOGket oN olose', tunction TY + 上 只 会 出 现 一 次 
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console.log('"close" event ' ) ; . | 
} 设 定 错误 处 理 器 以 防止 
socket ,on('error', function (ey +1 出 现 未 捕获 的 异常 
console.log('"error" event’', e);: 


上 上 二 
Socket.pipe (socket).,; 
}} .listen(1337}); 


局 动 服 务 硕 ， 用 netcat 或 telnet 连 上 去 玩 一 玩 。 当 你 在 客户 端 程序 中 涡 键 盘 时 ， 应 该 能 在 服务 
露 的 stdout 中 看 到 跟 事 件 对 应 的 console.1log() 输 出 。 

你 能 在 Node 中 构建 底层 的 TCP 服 务 器 了 ,你 应 该 还 想 知道 在 Node 中 如 何 做 一 个 能 跟 这 些 服 务 
需 交 互 的 客户 端 程序 。 我 们 现在 就 去 做 一 个 吧 。 











13.2.3 ”创建 TCP 客 尸 端 


Node 不 仅 可 以 做 服务 器 软 件 ， 创 建 客户 问 网 络 程序 同样 既 实 用 叉 人 简便。 

创建 到 TCP 服 务 需 的 原始 连接 关键 是 net.connect () 哺 数 ， 它 可 以 接受 一 个 指定 host 和 和 
port 值 的 配置 项 参数 ， 并 返回 一 个 socket 实 例 。net .connect() 返 回 的 socket 开 始 并 没有 连 
到 服务 融 上 ， 所 以 一 般 在 你 用 socket 做 什么 事情 之 前 要 监听 connect 事 件 : 


var net = require('net')}).; 





var socket = net.connect({ port: 1337, host: 'localhost' }}); 
socket.on('connect', function () { 
// 开始 编写 你 的 "请 求 " 
socket .write('HELO local.domain.name\r\n').; 
ee 
socket 实 例 连 上 服务 融 之 后 ， 它 的 表现 就 像 之 前 你 在 net .Server 回 调 函 数 中 得 到 的 socket 
实例 一 样 。 
为 了 演示 一 下 , 我 们 写 一 个 netcat (1) 命令 的 简单 复制 品 , 代码 在 下 面 的 清单 中 。 这 个 程序 
基本 上 就 是 连接 到 -个 特定 的 远程 服务 船上 ， 将 程序 的 stdin 送 到 socket 中 ， 然后 再 把 socket 的 
啊 应 放 到 程序 的 stdout 中 。 


代码 清单 13-6 ”用 Node 实 现 netcat (1) 命令 的 简单 复制 品 











var net = require('net'); 
Var host = process.argv[l2]; 从 命令 行 参 数 中 解析 出 
Var port = Number (process.argv[l3|]); 主机 和 痛 口 
_ 创建 socket 实例 并 开 
Var sgocket = net,connect (port, host); 始 连接 服务 器 
让 多、 口 人 EE a 下 
到 服务 器 的 连接 建立 好 
人 socket.on('connect', function () { 后 处 理 connect 事 件 


socket 





process.stdin.pipe(socket); 
将 socket 的 S00ket poeloroecesss Stdout); 0 
数据 传 给 进 日 ) 头 刁 妇 
程 的 stdout } ) 


process.stdin.resume().; 


图 灵 社 区 会 员 quqingtao 专 享 尊重 版 权 


290 第 13 章 超越 Web 服务 器 


当 发 生 event 事 件 
socket.on('end', function () { 时 中 断 stdin 
process.stdin.pause().; 


1) 3 
你 可 以 用 这 个 客户 疹 连 接 你 之 前 写 的 TCP 服 务 硕 。 或 者 如 条 你 是 星际 迷 的 话 ， 可 以 用 下 面 这 
个 参数 调用 这 个 netcat 复 制品 的 脚本 看 看 复活 市 彩 集 : 
$s node netcat.s towel .blinkenlights.nl 23 


和 舒 千 服 服 地 坐 好 ， 孕 受 图 13-3 中 的 输出 吧 。 你 应 该 休息 一 下 了 。 














和 日 日 3. node ww 


We "re doomed! 


EL 
VANANINWYW 





图 13-3 ”用 netcat,js 脚 本 连接 ASCI 星 战 服务 硕 


这 就 是 用 Node.js 写 底层 TCP 服 务 絮 和 客户 端 所 需要 的 一 切 。net 模 块 提供 了 简单 而 又 完备 的 
API，Socket 类 就 像 你 想 的 那样 遵循 了 既 可 读 又 可 写 的 Stream 接 口 。net 模 块 基本 上 就 是 Node 核 
心 基础 的 展示 。 

让 我 们 再 次 启程 ,去 看 一 看 可 以 用 来 跟 线程 的 环境 进行 交互 , 以 及 可 以 查询 运行 时 和 操作 系 
统 相关 信息 的 Node 核 心 API。 


13.3” 跟 操作 系统 交互 的 工具 


你 会 发 现 经 常 要 跟 Node 所 在 的 环境 交互 。 比 如 检查 环境 变量 启用 debug 模 式 的 日 志 ， 用 底层 
郧 数 跟 /dev/js0( 游戏 手柄 的 设备 文件 ) 交互 实现 Linux 下 的 手柄 驱动 , 或 者 启动 一 个 像 php 这 样 的 
外 部 子 进程 编译 PHP 上 脚本 。 

所 有 这 些 动 作 都 要 用 到 Node 的 一 些 核心 API， 也 就 是 我 们 在 这 一 节 中 要 介绍 的 内 容 : 
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口 全 局 的 process 对 象 一 一 包含 当前 进程 的 相关 信息 ， 比 如 传 给 它 的 参数 和 当前 设 定 的 环 
境 变量 ; 

口 fs 模块 一 一 包含 高 层 的 ReadStream 和 WriteStream 类 ， 你 现在 应 该 已 经 掌握 了 ,但 还 
有 我 们 即将 介绍 的 底层 函数 ; 

D chi 1d_process 模 块 繁衍 子 进程 的 底层 和 高 层 接口 , 以 及 一 种 繁衍 党 有 双 问 消息 传 
递 通道 node 实 例 的 特殊 办 法 。 

在 这 些 API 中 ，process 是 一 个 大 多 数 程 序 都 会 与 之 打交道 的 对 象 ， 所 以 我 们 先 从 它 开 始 。 


13.3.1 单 例 的 全 局 process 对 象 


每 个 Node 进 程 都 有 一 个 单 例 的 全 局 process 对 象 , 由 所 有 模块 共享 访问 。 在 这 个 对 象 中 可 以 
找到 关于 该 进程 及 其 所 在 的 上 下 文 的 相关 信息 。 比 如 说 , 可 以 用 process .argv 访 问 Node 运 行当 
前 脚本 时 传人 的 参数 , 还 可 以 用 process .env 对 象 获 取 或 设 定 环 境 变 量 , 但 更 有 趣 的 是 process 
对 象 并 不 是 EventEmitter 实 例 它 会 发 出 非常 特殊 的 事件 ， 比如 exit 和 uncaughtException。 

process 对 象 有 很 多 花 里 胡 哨 的 东西 ， 有 些 本 市 没有 涉及 的 API 会 在 本 章 后 续 革 市 中 讲 到 。 
本 方 的 重点 是 : 

口 用 process .env 获 取 和 设 定 环境 变量 ; 

男 监听 pzrocess 发 出 的 特殊 事件 比如 exit 和 uncaughtException; 

口 监听 process 发 出 的 单 例 事 件 ， 比 如 SIGUSR2 和 SIGKILL。 

1. 用 process .env 获 取 和 设 定 环境 变量 

环境 变量 对 于 改变 程序 或 模块 的 工作 方式 很 有 帮助 。 比 如 用 这 些 变量 配置 服务 硕 ， 指 定 它 
监听 的 端口 。 或 者 操作 设 定 TMPD 了 下 变量 指定 程序 应 该 把 临时 文件 输出 到 哪个 目录 并 在 后 面 清理 
它们 。 


















































环境 变量 ? ”如果 你 还 不 清楚 什么 是 环境 变量 ， 我 可 以 告诉 你 ， 它 们 是 一 组 键 / 值 
对 ， 任 何 进 程 都 可 以 用 它们 调整 自己 的 行为 。 比 如 说 ， 所 有 操作 系统 都 定义 了 一 个 文件 
路 径 清单 的 环境 变量 PATH， 用 来 根据 名 称 搜寻 程序 的 位 置 ( 比如 1s 被 解析 为 /bin/ls )。 
假如 你 想 在 开发 或 调试 模块 时 启用 调试 模式 的 日 志 输 出 , 但 在 常规 使 用 时 不 用 ,因为 那样 用 
户 会 觉得 很 烦 。 用 环境 变量 可 以 很 好 地 解决 这 个 问题 。 你 可 以 像 下 面 的 代码 一 样 ， 检 查 


上 三 


ProCcess.enyv. DEBUG 看 变量 DEBUG 设 定 的 是 1 | o 


代码 清单 13-7 ”根据 环境 变量 DEBUG 定 义 qaepug 男 数 














ss 根据 环境 变量 DEBUG 定 义 
if (process.env.DEBUG) { debug 洱 数 

debug = function (data) { 

Console.error (data).; 如 果 设 定 了 DEBUG，adebug 函 数 

}; 会 将 参数 输出 到 stqerr 中 
} else { 

debug 二 function () {}; 如 果 没 设 定 DEBUG， aebug 
函数 为 空 ， 什 么 也 不 做 
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debug( 'this LIS 已 debug call"}); . 、 
在 代码 中 各 处 调用 debug 函 数 


> 


console.log('Hello World!'); 

debug('this another debug call'); 

如 果 你 按照 津 规 方 式 运 行 这 上 段 脚 本 (不 设 定 环 境 变 量 process .env.DEBUG )， 调 用 debug 
什么 也 不 会 做 ， 因 为 调用 的 是 空 函 数 : 


S node debug-mode,.1]s 
Helilo Worild! 


要 试 一 下 调试 模式 ， 需要 设 定 环境 变量 process .env .DEBUG。 最 简单 的 做 法 是 在 启动 Node 
实例 时 在 命令 前 加 上 DEBUG=1。 当 处 于 调试 模式 时 ,常规 的 输出 ， 以 及 调用 depbug 函 数 的 输出 都 
会 显示 在 控制 合 中。 在 调试 代码 时 ， 用 这 种 办 法 获取 问题 的 诊断 报告 很 棒 : 

$s DEBUG=1 node debug~mode.1s 

this is a debug call 


Hello World! 
this 1is another debug call 


T. J. Holowaychuk 做 得 社区 模块 debug ( https://github.com/visionmedia/debug ) 封装 了 这 一 功 
能 ， 还 有 些 其 他 特性 。 如 有 果 你 喜欢 这 里 介绍 的 调试 技术 ， 一 定 要 看 看 这 个 模块 。 

2. 进程 发 出 的 特殊 事件 

process 对 象 通常 会 发 出 两 个 特殊 事件 : 

口 进程 退出 之 前 发 出 的 exit; 

口 有 末 处 理 的 错误 被 抛 出 时 发 出 的 uncaughtException。 

对 于 所 有 要 在 退出 前 完成 某 些 任 务 ( 比如 清理 对 象 或 向 控制 台 输 出 最 后 一 条 消息 ) 的 程序 来 
说 ，exit 事 件 是 必 不 可 少 的 。 有 一 点 值得 注意 ，exit 事 件 是 在 事件 循环 ( event loop ) 停止 之 后 才 激 
发 的 ， 所 以 你 没有 机 会 在 exit 事 件 期 间 启 动 任何 异步 任务 。 退 出 码 是 第 一 个 参数 ， 成 功 退 出 时 为 0。 

我 们 来 写 一 个 监听 exit 事 件 的 脚本 ， 输 出 一 条 “Exiting…” 消 息 : 

process.on{t'exit', function (code) { 

console.l1og('Exiting...'); 


})} 
uncaughtException 事 件 是 进程 发 出 的 另 一 个 特殊 事件 。 完 美的 程序 中 不 会 出 现 未 捕获 的 异 


常 , 但 在 现实 中 最 好 还 是 别 冒 险 。uncaughtException 事 件 只 有 一 个 参数 ,未 捕获 的 Error 对 象 。 
如 果 没 有 “错误 ”事件 的 监听 器 ,任何 未 捕获 的 错误 都 会 搞 垮 进程 ( 这 是 大 多 数 程序 的 默认 
行为 )， 但 只 要 有 一 个 监听 器 ， 就 由 监听 需 决 定 如 何 处 理 错 误 。Node 不 会 自动 退出 ， 所 以 在 你 自 
己 的 回调 中 一 定 要 这 样 做 。Node.js 文 档 明 确 指出 ， 使 用 这 个 事件 时 应 该 在 回调 中 包含 
process .exit(); 否则 会 让 程序 处 于 不 确定 的 状态 中 ， 这 很 糟糕 。 
我 们 动手 写 一 个 程序 看 一 下 对 uncaughtException 的 监听 ， 并 抛 出 一 个 未 捕获 的 错误 : 


Drocess.oconl 'uncaughtException', function (err) 1{ 
Console,.error('got uncaught exception:', err.message).: 





















































process.exit (1). 


}); 


throw new Error('an uncaught exception'),; 
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这 样 当 有 不 可 预料 的 错误 出 现时 , 你 就 可 以 捕获 这 个 错误 , 并 在 退出 进程 之 前 完成 必要 的 清 
理工 作 。 
3. 捕获 发 送 给 进程 的 信号 
UNIX 有 信号 的 概念 ， 是 进程 间 通 信 (IPC ) 的 基本 形式 。 这 些 信号 非常 原始 ， 只 能 使 用 一 组 
国定 的 名 称 ， 并 且 不 能 传递 参数 。 
Node 提 供 了 一 些 信号 的 默认 行为 ， 现 在 我 们 就 过 一 下 : 
口 SIGINT 在 按 下 Ctrl-C 时 由 shell 发 送 。Node 的 默认 行为 是 杀 掉 进程 ， 但 该 行为 可 以 由 进 
程 上 SIGINT 的 单 例 监听 病 禾 兰 ; 
D sSIGUSR1 收 到 这 个 信号 时 ，Node 会 进入 它 内 置 的 调试 器 ; 
口 SIGWINCH 在 调整 终端 大 小 时 由 shell 发送。 收 到 这 个 信号 时 ，Node 会 重新 设 定 
ptrocess .stdout .rows 和 process.stdout .columns， 并 发 出 一 个 resize 事 件 。 
这 是 Node 对 这 三 个 信和 号 的 默认 处 理 ， 但 你 也 可 以 在 process 对 象 上 监听 这 些 信号 ， 调 用 回 
调子 数 。 
假设 你 写 了 个 服务 器 ,但 在 你 按 下 Ctrl-C 要 杀 掉 服务 右 时 ， 这 种 关闭 不 干净 ， 并 且 所 有 等 待 
中 的 连接 都 会 被 丢掉 。 解 决 办 法 是 捕获 SIGINT 信 号 并 阻止 服务 融 接受 连接 ， 并 在 结束 进程 之 前 完 

















成 所 有 已 有 连接 的 处 理 。 监 听 process.on('SIGINT'，...) 可 以 实现 这 一 办 法 。 事 件 名 称 就 是 
信号 名 称 : 
process.on{'SIGINT', function () { 


Console.log('Got Ctrl-C!')}):; 
Server.closet{).; 


I 

现在 按 Ctrl-C 键 , 会 从 你 的 shell 回 Node 进 程 发 送 STGINT 信 号 ,从 而 调用 你 注册 的 回调 而 不 是 
杀 挥 进程 。 因 为 大 多 数 程序 默认 的 行为 是 退出 进程 ， 所 以 在 你 上 自己 的 SIGINT 处 理 硕 中 最 好 也 是 
这 样 ， 在 做 完 所 有 必需 的 关闭 动作 之 后 。 在 这 个 例子 中 证 服务 硕 停 止 接 有 连接 了 可 以 了 。 在 
Windows 下 也 是 这 样 ， 尽管 它 缺 乏 恰 当 的 信号 ， 但 Node 会 处 理 等 同 的 Windows 动 作 ， 并 在 Node 
中 模拟 了 人 造 信号 。 

你 可 以 用 这 个 技术 捕获 发 给 Node 进 程 的 任何 UNIX 信 号 。 这 些 信 号 列 在 了 维基 百科 上 关于 
UNIX 信 号 的 文章 中 : http://wikipedia.org/wiki/Unix signal#POSIX _ sign。 很 不 等 ， 信号 一 般 不 能 
用 在 Windows 上 ， 只 能 用 几 个 模拟 的 信号 : SIGINT、SIGBREAK、SIGHUP 和 SIGWINCH。 


13.3.2 ”使 用 文件 系统 模块 
全 模块 提供 了 跟 文 件 系 统 交 互 的 函数 。 其 中 的 大 多 数 都 有 一 一 对 应 的 C 函 数 ， 但 也 有 像 


fs.readqFile()、fs.writeFile()、fs.ReadStream 和 fs.WriteStream 类 这 样 的 高 层 抽象 ， 
它们 构建 在 open () 、read() 、write() 和 close() 之 上 。 

几乎 所 有 底层 也 数 的 用 法 痢 跟 对 应 的 C 函 数 用 法 一 样 。 实际 上 ， 大 部 分 Node 文 档 都 指 问 了 对 
应 man 页 面 中 的 C 孙 数 解释 上 。 你 很 容易 找 出 这 些 抵 层 函 数 ， 因 为 它们 总 会 有 一 个 对 应 的 同步 版 
本 。 比 如 fs .stat() 和 fs. statSync() 是 C 员 数 stat (2) 的 底层 绑 定 。 
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Node.js 中 的 同步 函数 如 你 所 知 ，Node 的 API 大 部 分 是 异步 函数 ， 从 不 阻塞 事 

件 循环 ， 那 么 为 什么 还 要 大 费 周章 地 引入 这 些 文件 系统 函数 的 同步 版 本 呢 ? 因为 Node 

自己 的 require() 地 数 是 同步 的 ， 并 且 它 的 实现 用 到 了 fs 模块 的 函数 ， 所 以 必须 有 同步 

版 。 无 论 如 何 , 同步 函数 只 应 该 用 在 启动 时 , 或 者 模块 最 初 加 载 时 , 之 后 再 也 不 要 用 了 。 

我 们 来 看 几 个 跟 文件 系统 交互 的 例子 。 

1. 移动 文件 

一 个 看 起 来 简单 , 并且 非常 律 见 的 文件 系统 交互 任务 , 是 把 文件 从 一 个 目录 挪 到 为 一 个 目录 
中 。 在 UNIX 平 台 上 用 mv 命令 ，Windows 上 是 move 命 令 。 在 Node 中 做 相同 的 事情 是 不 是 也 应 该 同 
样 简单 ? 

好 吧 ， 如 果 你 在 REPL 或 文档 中 (http:/nodejs.org/apif.html ) 浏览 fs 模块 ， 会 发 现 根本 没有 
fs .move () 函数 。 但 有 一 个 fs .zxename () 国 数 ， 如 末 你 仔细 想 想 ， 它 们 是 一 样 的 。 完 美 ! 

但 这 里 没 那 么 快 。fs .rename () 直接 对 应 C 困 数 *ename (2) ,这 个 子 数 有 个 怪 毛 炳 , 它 不 能 跨 
越 物理 设备 〈 比 如 两 个 硬盘 )。 也 就 是 说 下 面 的 代码 无 法 正常 工作 ， 并 日 会 抛 出 一 个 EXDEV 错 误 : 

fs.rename('C:\\hello.txt', 'D:\\hello.txt', function (err) ({ 


/:/: err.code === 'EXDEY,' 
}); 


现在 怎么 办 ? 好 吧 ， 你 仍然 可 以 在 DA\ 上 创建 一 个 新 文件 ， 并 读 取 CN 上 的 文件 ， 所 以 可 以 路 
盘 复 制 文 件 。 了 解 了 这 一 点 ， 你 可 以 创建 一 个 经 过 优化 的 move () 函数 ， 可 能 时 调用 快速 的 
fs.rename ( ) ， 必要 时 用 fs .ReadqSstream 和 fs .WriteStream 把 文件 从 一 个 设备 复制 到 男 一 个 
设备 中 。 下 面 的 代码 清单 中 就 是 这 种 实现 。 


代码 清单 13-8 可 能 时 重 命名 ， 并 以 复制 为 后 备 手段 的 move () 函数 


var fs = require('fs'); 



































module.exports = function move (oldPath, newPath, callback) { 


fs.rename (oldPath, newPath, function (err) { ‘EE 
| 调用 fs .rename () 
1f (err) { 


计 -3 t 月 呈 和 E 
巴 
if (err.code === 'EXDEV') { 如 果 出 现 EXDEV 错 误 ， ope 
copy(); 用 备用 的 复制 技术 
} else { 
allbasklore): 如 果 有 其 他 错误 ， 失 败 
} 并 报告 给 调用 者 
return; 
} 
callback (); 如 果 fs .rename() 能 用 ， 
es 则 工作 已 经 完成 了 
function copy () { 
Var readSstream = fs.createReadstream(oldPath); 有 i 
Var writeStream = fs.createWriteStream (newPath).， i i 
readStream.on('error', callback).; 输出 到 目标 路 径 
writeStream.on('error', callback).; 
readStream.on('close', function () { 
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fs.unlink(oldPath, callback); 复制 完成 后 断 链 (删除) 
jy 原文 件 


readStream.pipe (writeStream).; 


} 


} 
如 果 你 愿意 ， 可 以 在 node REPL 中 直接 测试 这 个 模块 . 


S node 
> Var move = redquire{'./copy') 
> move('copy.js', 'Copy.Js.bak’', function (err) { 1if (err) throw err 1}) 





注意 ， 这 个 copy 国 数 只 能 用 在 文件 上 ， 目 录 不 行 。 要 文 持 目录 复制 ， 你 必须 先 检 查 给 定 的 
路 径 是 否 为 目录 ， 如 果 是 , 则 调用 fs .readdir()， 必 要 时 还 要 调用 fs .mkdir()。 你 可 以 目 己 
实现 这 个 特性 。 

fs 模块 的 错误 码 ”fs 模块 为 文件 系统 错误 码 返 回 的 是 标准 的 UNIX 名 称 ( www.gnu. 
org/software/libc/manual/html node/Error-Codes.htm )， 所 以 你 要 对 那些 名 称 有 个 大 致 的 了 解 。 

其 至 在 Windows 上 , 这 些 名 称 也 被 libuv 规 范 化 了 ， 所 以 你 的 程序 一 次 只 需 检 查 一 个 错误 码 。 

根据 GNU 的 文档 , 当 “ 检 测 到 试图 跨越 文件 系统 做 不 正确 连接 时 ”, 就 会 出 现 EXDEV 错 误 。 


2. 监测 目录 或 文件 的 变化 

fs .watchFile() 很 早 就 出 现 了 。 因 为 它 用 轮 询 的 方式 检查 文件 是 否 发 生 了 变化 ， 所 以 在 某 
些 平 侣 上 很 耗资 源 。 也 就 是 说 ,， 它 stat () 文件 ,在 短暂 的 等待 之 后 再 次 stat () ， 就 这 样 一 卫 循 
环 ， 在 文件 发 生变 化 时 就 调用 监测 者 函数 。 

假定 你 正在 重 写 一 个 对 系统 日 志文 件 的 变化 进行 记录 的 模块 。 为 此 你 想 要 一 个 在 全 局 
system.log 文 件 被 修改 时 可 以 调用 的 丽 数 : 

















var fs = YeGulre( ' is') ， 
fs.watchFile('/var/liog/system.1log', function (curr, prev) { 
IE {curr.mtime.getTime{()} !== prev.mtime.getTime{)) { 
Console.iog('"system.1log" has been modified'). 


} 
}}; 


变量 curr 是 当前 的 fs .stat 对象, prev 是 前 一 个 fs .stat 对 和 象 , 它 俩 应 该 有 同一 个 文件 上 
的 不 同时 间 惟 。 这 个 例子 中 比较 了 mtime 的 仁 ， 因 为 你 只 想 在 文件 被 修改 时 收 到 通知 ， 而 不 是 在 
它 锌 访问 时 。 

fs.watch() 是 在 Nodev0.6 中 引入 的 。 就 像 我 们 之 前 说 的 ， 因 为 它 用 平台 本 地 的 文件 修改 通 
知 API 监 测 文件 ， 所 以 它 比 fs.watchFile() 性 能 更 优 。 因 此 这 个 函数 也 能 监测 一 个 目录 下 任 一 
文件 的 变化 。 实 际 上 ，fs .watch() 不 如 fs .watchFile() 可 靠 ， 因 为 各 种 平台 底层 的 文件 监测 
机 制 是 不 同 的 。 比 如 说 ， 在 OS X 上 监测 目录 时 不 会 报告 参数 filename， 并且 这 要 由 苹果 在 以 后 
发 布 的 OS X 上 修改 。Node 的 文档 http://nodejs.org/api/fs.html#fs caveats 中 列 出 了 这 些 注意 事项 。 

3. 使 用 社区 模块 : fstream 和 filed 

如 你 所 见 ，fs 模 块 , 像 Node 的 所 有 核心 API 一 样 ， 绝对 是 底层 的 。 那 就 是 说 有 充足 的 创新 空 
则 ,并 且 可 以 在 其 上 创造 很 棒 的 抽象 层 。npm 上 的 Node 活 跃 模 块 每 天 都 在 增长 ,并且 你 可 能 猜 到 
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了 ， 其 中 有 一 些 优 质 的 fs 扩展 模块 。 

比如 Isaac Schlueter 的 fstream 模 块 ( https://github.conmyisaacs/fstream ) 是 npm 上 日 身 的 一 个 核心 组 
件 。 这 个 模块 很 有 趣 ， 因 为 它 最 开始 是 apm 的 一 部 分 ， 后 来 因为 它 的 通用 功能 可 以 用 在 很 多 命令 
行程 序 和 系统 管理 脚本 上 , 所 以 被 剥离 出 来 了 。 让 fstream 脱 颓 而 出 的 优秀 特性 之 一 是 它 对 许可 权 
限 和 符号 链接 的 处 理 ， 在 复制 文件 和 目录 时 是 殉 认 维护 的 。 

依 助 ftream， 只 需 将 Reader 实 例 接 到 Writer 实例 上 ， 束 可 以 达到 执行 cp -rp 源 目 录 目标 
目录 (递归 地 复制 一 个 目录 及 其 中 的 内 容 ， 并 传送 所 有 权 和 授权 许可 ) 的 效 采 。 在 下 面 这 个 例子 
中 ， 我 们 用 fstream 的 过 滤 顺 功能 基于 回调 因数 按 条 件 排 除 文件 : 

fstream 


.Reader ("path/to/dir") 
.pipe (fstream.Writer({ path: "path/to/other/dir", filter: isValid ) 





// 检查 即将 写 入 的 文件 并 返回 它 是 否 应 该 被 复制 
function isValid () { 

// 匆 略 TextMate 之 类 的 文本 编辑 器 创建 的 临时 文件 

return this.pathlthis.path.length - 1] !== 一 ; 
} 


Mikeal Rogers 的 filed 模 块 ( https://github.com/mikeal/filed ) 也 是 比较 有 影响 力 的 模块 , 主要 是 
为 它 的 作者 就 是 极其 流行 的 request 模 块 的 作者 。 这 些 模 块 让 一 种 新 的 流程 控制 变 得 比 Stream 
实例 更 流行 : 监听 pipe 事 件 ， 然 后 基于 传 给 它 的 东西 〈 或 它 传 出 去 的 东西 ) 执行 不 同 的 动作 。 

为 了 演示 这 种 方式 的 强大 之 处 ， 我 们 来 看 一 下 fed 如何 将 普通 的 HTTP 服 务 带 变 成 一 个 功能 
完备 的 静态 文件 服务 硕 ， 只 要 一 行 代码 : 

http.createServer (function {redq, res} { 


req.pipe (filed{('path/to/static/files'})) .pipe (res); 
Hi; 


这 上 段 代 码 会 跟着 正确 的 缓存 头发 送 Content-Length。 如 果 浏 览 器 已 经 绥 存 了 文件 ，field 会 
用 304 未 修改 啊 应 HTTP 请 求 ， 不 再 从 硬盘 中 打开 文件 读 取 它 。 这 些 优 化 就 是 基于 pipe 事 件 才 能 
做 的 ， 因 为 filed 实 例 能 访问 HTTP 请 求 的 rea 和 res 对 象 。 

我 们 刚 介 绍 了 两 个 优秀 的 社区 模块 ， 它 们 以 基本 的 fs 模块 为 基础 ， 提 供 了 更 棒 的 功能 或 漂亮 
的 API， 但 实际 上 这 样 的 模块 还 有 很 多 。 你 可 以 用 npm search 命 令 为 给 定 任务 查找 已 发 布 的 模 
块 。 比 如 你 想 再 找 一 个 可 以 简化 文件 复制 的 模块 : 执行 npm search copy 就 能 找到 一 些 比 较 有 
用 的 结果 。 在 你 找到 一 个 看 起 来 有 意思 的 模块 时 ， 可 以 执行 hpm info module-name 获 取 关 于 
模块 的 信息 ， 比 如 它 的 描述 、 主 页 、 发 布 版 本 等 。 不 管 你 面临 的 是 什么 任务 ,很 可 能 已 经 有 人 演 
试 过 用 npm 模 块 解决 那个 问题 了 , 所 以 在 你 从 头 开始 编 写 什 么 东西 之 前 , 一 定 记得 先 去 检查 一 下 。 


























13.3.3 ”繁衍 外 部 进程 


Node 提 供 了 child process 模 块 ， 在 Node 服 务 需 或 脚本 内 创建 子 进 程 。 这 里 有 两 个 API: 一 个 高 
层 的 exec () 和 一 个 底层 的 spawn ()。 这 两 个 任何 一 个 都 可 能 适用 ， 这 取决 于 你 需要 什么 。 还 有 一 
种 创建 Node 自 身子 进程 的 特殊 办 法 ， 用 内 置 的 特殊 了 PC 通道 fork0。 所 有 这 些 函 数 都 有 不 同 的 用 途 : 
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口 cp .exec () 一 一 在 回调 中 繁衍 命令 并 缓冲 结果 的 高 层 API; 

口 cp. spawn () 一 一 将 单 例 命令 繁衍 进 Child-Process 对 和 象 中 的 底层 API; 

口 cp.fork() 一 一 用 内 置 的 PC 通道 繁衍 额外 Node 进 程 的 特殊 办 法 。 

我 们 挨个 看 一 下 这 些 API。 

子 进程 的 好 与 坏 使 用 子 进 程 婚 有 好 处 ， 也 有 不 足 。 一 个 明显 的 缺点 是 需要 执行 装 

在 用 户 机 器 上 的 程序 ， 你 的 应 用 要 依赖 于 它 。 另 一 种 选择 是 用 JavaScript 完 成 子 进程 的 

工作 。npm 就 是 很 好 的 例证 ， 它 原来 用 tar 命 令 解 开 Node 包 。 因 为 各 个 不 兼容 版 本 的 tar 

会 产生 冲突 ， 所 以 这 样 会 出 问题 ， 并 且 Windows 上 几乎 很 少 有 安 鞘 tar 的 。 正 是 因为 这 些 

问题 ， 出 现 了 完全 用 JavaScript 写 的 node-tar ( https://github.com/isaacs/mode-tar )， 没 有 使 

用 任何 子 进程 。 

另 一 方面 ， 使 用 外 部 程序 让 开发 者 可 以 借用 由 其 他 语言 编写 的 丰 雷 应 用 。 比 如 gm 

( http://aheckmann.github.com/gm/ ) 模块 ， 用 强大 的 GraphicsMagick 和 ImageMagick 库 在 

Node 程 序 中 执行 各 种 图 片 的 处 理 和 转换 操作 。 

1. 用 CP.EXEC() 缓 冲 命 令 结果 

在 你 想 要 调用 一 个 命令 , 并 且 只 关心 最 终结 果 , 不 想 数据 边 到 边 从 子 进程 的 stdio 流 中 访问 数 
据 时 ， 可 以 使 用 高 层 API，cp .exec ()。 这 个 API 人 允许 你 输入 整 串 的 命令 ， 包 括 连 接 成 管道 的 多 
个 进程 。 

在 你 接受 被 执 行 的 用 户 命 令 时 就 可 以 用 exec () API。 比 如 你 要 写 一 个 耻 C 机 硕 人 , 想 在 用 户 
输入 以 句号 (开头 的 东西 时 执行 命令 。 比 如 用 户 输入 .1s 作 为 耻 C 消 息 ， 机 器 人 应 该 执行 1s 并 在 
IRC 房 间 中 输出 返回 结果 。 代 人 码 如 下 所 示 ， 你 需要 设 定 超时 选项 ， 这 样 从 来 部 不 会 结束 的 进程 就 
会 在 经 过 一 段 时 间 后 被 自动 杀 挥 。 


代码 清单 13-9 ”用 cp. exec () 运 行 用 户 通过 IRC 机 器 人 输入 的 命令 














每 条 发 送 给 

IRC 房 间 的 

消息 都 会 发 | var cp = require('child process'); room 对 象 表 示 到 IRC 房 间 的 连接 
出 message room.on('message', function (user, message) { 《来 目 示 个 假想 的 IRC 模 块 ) 

事件 -> if (message[0] === '.') (人 

仿 查 消息 是 一 > Var command = message.substring(1).; 

vy EH i : 

否 用 句号 打 cp.exec (command, { timeout: 15000 }, 繁衍 子 进 程 ， 并 让 Node 在 回调 中 
头 function (err, stdout, stderr) { 缓冲 结果 ，15 秒 后 超时 

、 if (err) { 


room.sayl 
'Error executing command "' + command + '"; ' + err.message 
. ) ; 
room.say (stderr}:; 
} else 1 
room.say('Command completed: ' + command).: 
room.say {stdout)}); 
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); 
} 
}); 


npm 注 册 中 心里 已 经 有 一 些 实现 了 IRC 协 议 的 很 好 的 模块 了 了 ， 所 以 如 果 你 大 的 想 写 一 个 IRC 
机 妖 人 ， 肯 定 应 该 用 一 个 现成 的 模块 (npm 注 册 中 心里 的 irc 和 ire-js 都 很 受 欢 迎 )。 

有 时 候 你 需要 缓冲 命令 的 输出 ， 但 希望 Node 可 以 自动 帮 你 转 义 参数 ， 这 时 可 以 用 execFile() 
国 数 。 这 个 因数 有 四 个 参数 ,不 是 三 个 , 传人 要 运行 的 可 执行 命令 ， 以 及 调用 这 个 可 执行 命令 时 
给 出 的 参数 数组 。 当 你 必须 增 量 地 构建 子 进 程 要 用 的 参数 时 ， 这 个 很 好 用 : 

cp.execFile('ls', [ '-1', process.cwd{(}) ]， 

function (err, stdout, stderr) 1 
if (err) throw err,; 


console.error{({stdout}); 


}}}; 
2. 用 cp .spavm () 繁衍 囊 有 流 接口 的 命令 
Node 中 繁衍 子 进程 的 底层 API 是 cp. spawn () 。 这 个 图 数 跟 cp .exec () 不 同 ， 因 为 它 返 回 你 
可 以 与 之 交互 的 childqProcess 对 象 。 你 不 用 给 cp .spawn () 一 个 进程 完成 时 的 回调 晒 数 ， 
cp.spawn () 允许 你 跟 每 个 子 进程 的 stdio 流 交互 。 
cp .spavwn () 最 基本 的 用 法 看 起 来 如 下 所 示 : 


Var child = cp.spawn('ls', [ '-1' ]); 




















// stdout 是 一 个 普通 的 Stream 实 例 ， 会 发 出 'data'、'end' 等 ， 
child.stdout.pipe (fs.createWriteStream('ls-result.txt')); 


child.on('exit', function (code, signal) { 
// 在 子 进程 退出 时 发 出 

}); 

第 一 个 参数 是 你 要 执行 的 程序 。 这 可 能 是 单个 程序 名 ， 可 以 在 当前 的 PATH 中 查找 它 ， 或 者 
是 指 回程 序 的 绝对 路 径 。 第 二 个 参数 是 调用 进程 的 参数 字符 串 数 组 。ChildProcess 对 象 默 认 情 况 
下 包含 三 个 内 置 的 Stream 实 例 ， 你 的 脚本 可 以 与 之 交互 : 

口 child.stdqin 是 可 写 的 stream， 表 示 子 进程 的 stdqin; 

DD child. stdout 是 可 读 的 Stream， 表示 子 进 程 的 stdout: 

口 child.stderr 是 可 读 的 Stream， 表 示 子 进程 的 stderr。 

你 可 以 对 这 些 流 做 任何 事 ， 比 如 将 它们 转 到 文件 或 socket 中 ， 或 其 他 可 写 流 中 。 如 果 你 想 ， 
甚至 可 以 完全 忽略 它们 。 

childqProcess 对 象 上 还 有 另外 一 个 有 趣 的 事件 exit, 在 进程 退出 并 且 相 关 的 流 全 部 结 
时 激发 。 

node-cgi ( https://github.com/TooTallNate/node-cgi ) 是 一 个 将 cp .spawn () 的 使 用 抽象 成 实用 
功能 的 优秀 范例 模块 , 它 让 你 可 以 在 Node HITP 服 务 硕 中 重用 遗留 的 通用 网 关 接 口 (CGI ) 脚本 。 
CGI 实际 上 只 是 一 种 啊 应 HTTP 请 求 的 标准 ， 它 将 CGI 脚本 作为 HTTP 服 务 器 的 子 进 程 调用 ， 用 特 
殊 的 环境 变量 描述 请 求 。 比 如 写 这 样 一 个 CGI 脚本 将 sh 作为 CGI 接口 : 
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#!/bin/sh 

echo "Status: 200" 

echo "Content-Type: text/plain'" 
echo 

echo "Hello $QUERY_STRING'" 


如 果 你 将 那个 文件 命名 为 hello.cgi 不 要 忘 了 执行 chmod +x hello.cgi 让 它 变 成 可 执行 的 )， 
只 需 一 行 代 码 承 可 以 让 它 在 你 的 HITP 服 务 硕 中 啊 应 HTTP 请 求 : 


var http = regquire('http'):; 
var col = require('cgi'); 








var server = http.createServer( cgi{'hello.cgi') }; 
server.listen(3000); 


这 个 服务 需 设 置 好 后 ， 当 有 HTTP 请 求 过 来 时 ，node-cgi 会 做 两 件 事 来 处 理 这 个 请 求 : 

口 用 cp . spawn () 将 hello.cgi 脚 本 作为 新 的 子 进程 繁衍 

口 用 一 组 定制 的 环境 变量 传递 与 当前 HTTP 请 求 有 关 的 新 进程 上 下 文 信 

hello.cgi 用 了 一 个 CGI 专用 的 环境 变量 ，oUERY_sTRING， 其 中 包含 请 求 URL 的 查询 字符 串 
部 分 。 这 上段 脚本 会 在 啊 应 中 使 用 它们 ， 会 写 在 脚本 的 stdout 中 。 如 果 你 启动 这 个 示例 服务 舌 ， 并 
用 curl 发 送 一 个 HTTP 请 求 给 它 ， 会 看 到 这 样 的 东西 : 


$s curl http://localhost:3000/2nathan 
Hello nathan 


子 进 程 在 Node 中 有 很 多 非常 棒 的 用 例 ，node-cgi 是 其 中 之 一 。 随 着 服务 器 或 应 用 程序 的 功能 
逐步 完善 ， 你 会 发 现 终究 要 和 它们 打交道 。 

3. 用 cp .fork() 分 散 工 作 负 和 载 

child_process 模 块 提 供 的 最 后 一 个 API 是 用 一 种 特殊 的 方式 坚 衍 额外 的 Node 进 程 ， 用 特殊 的 
内 置 IPC 通 道 , 既然 你 总 要 繁衍 Node, 传 给 cp. fork () 的 第 一 个 参数 是 要 执行 的 Node.js 模 块 的 路 径 。 

跟 cp. spawn () 一 样 ，cp .fork () 也 会 返回 childqProcess 对 象 。 主 要 区 别 是 这 个 API 是 用 
IPC 通 道 添加 的 : 子 进 程 现 在 有 一 个 child.send (message) 图 数 ， 并 且 用 fork () 调用 的 脚本 能 
外 监 昕 process .On('message') 事件 。 

假定 你 想 写 一 个 计算 斐 波 那 契 数列 的 Node HTTP 服 务 器 。 你 可 能 像 下 面 这 个 清单 中 一 样 幼稚 
地 把 整个 服务 大 一 次 性 与 好 。 


代码 清单 13-10 ”用 Node.js 实 现 的 非 最 优 斐 波 那 息 数列 HTTP 服 务 益 


var http = require('http'); 




















function fib (n) f{ 
i | 计算 斐 波 那 契 数 
return 1; 
} else { 
return fibln - 2) + fib{n - 1}). 
} 
} 
var server = http.createServerlfunction {regq, res}) { 
var num = parseInt (reg.uri.substring{1), 10); 
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res.writeHead (200).: 
res.end(fib(num) + "\n"); 


}}; 


server.listen(8000}).，; 


如 果 你 用 node fibonacci-naive.js 启 动 服务 兹 ， 并 发 送 一 个 HTTP 请 求 给 http://localhost: 
8000， 服 务 各 也 能 如 期 工作 ,但 计算 给 定数 值 的 辈 波 那 契 数列 是 一 个 昂贵 的 、 占 用 CPU 的 计算 。 
在 你 的 单线 程 Node 服 务 带 忙 着 计算 结 末 时 ， 它 没 办 法 处 理 额外 的 HTTP 请 求 。 此 外 ， 你 只 用 了 一 
个 CPU 内 核 ， 很 可 能 还 有 其 他 内 核 下 在 那里 无 所 事 事 。 这 很 差劲 。 

更 好 的 解决 方案 是 为 每 个 HTTP 请 求 复 制 Node 进 程 ,让 子 进程 做 昂 贯 的 计算 工作 并 返回 报告 。 
cp.fork() 为 此 提供 了 一 个 人 简洁 的 接口 。 

这 个 方案 涉及 两 个 文件 : 

口 ffbonacci-server.js 是 服务 从 ; 
口 ffbonacci-calc.js 负 责 计算 。 
首先 是 服务 规 : 


var http = require('http'); 
var Cp = require('child process');: 








Var server = http.createServer (functionl(regq, res) 1 
var child = cp.fork( filename, [ reg.url.substring(1}) ]}:; 
child.on('message', function(m) f 
res.end(m.result + An) 
上 
}; 
server.listen(8000).; 


服务 融 用 cp . fork () 把 斐 波 那 契 的 计算 逻辑 放 在 一 个 单独 的 Node 进 程 中 , 它 会 用 process. 
send() 问 父 进程 返回 报告 ， 就 像 下 面 的 fbonacci-calc.js 脚 本 那样 : 


function tapbplny { 
if (nn < 2) f{ 
return 1; 
} else { 
return fib(n - 2) + fibln ~- 1): 
} 
} 








var input = parselInt (process.argv|I2], 10);， 
process.send({ result: fib(linput) ] ) ， 


你 可 以 用 node fibonacci-server .js 启动 服务 上 麻 , 并 再 次 发 送 HTTP 请 求 到 http://localhost: 
8000 。 

这 个 例子 完美 地 展示 了 将 各 种 程序 组 件 分 解 到 多 个 进程 中 对 你 有 什么 样 的 好 处 。cp. fork () 
提供 了 childq.senda() 和 childq.on('message') 来 问 子 进程 发 送 和 接受 消息 。 在 子 进 程 中 ， 你 
可 以 用 process .send() 和 process.on('message') 问 父 进程 发 送 和 接受 消息 。 用 起 来 吧 ! 

我 们 接 下 来 再 去 看 看 如 何在 Node 中 开发 命令 行 工具 。 
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Node 脚 本 还 经 常用 来 构建 命令 行 工 具 。 现 在 你 应 该 已 经 见 悉 大 部 分 用 Node 编 写 的 命令 行 工 
具 了 : Node 包 管理 咒 ， 即 npm。 作 为 一 个 包 管 理 顺 ， 它 要 完成 大 量 操作 系统 级 的 操作 ， 并 且 要 索 
衍 子 进程 ， 所 有 这 些 都 是 用 Node 和 它 的 异步 API 完 成 的 。 这 样 npm 可 以 并 行 安装 包 ， 比 串 行 的 总 
体 进 度 更 快 。 如 果 可 以 用 Node 写 出 复杂 的 命令 行 工具 ， 那 用 它 做 什么 都 行 。 

大 多 数 命 令 行 程 序 都 有 相通 的 需求 ， 比 如 解析 命令 行 参 数 ， 谈 取 stdin， 写 人 stdout 和 stderr。 
本 市 会 介绍 编写 完整 的 命令 行程 序 的 常见 和 需求， 包括: 

口 解析 命令 行 参数 ; 

口 处 理 stdin 和 stdout 流 ; 

口 用 ansijs 给 输出 加 上 漂 腕 的 闫 色 。 

构建 优秀 的 命令 行程 序 ， 要 能 够 读 取 用 户 调用 程序 时 提供 的 参数 。 我 们 先 来 看 看 这 个 。 























13.4.1 解析 命令 行 参数 


解析 参数 是 一 个 简单 易 行 的 过 程 。Node 为 你 提供 了 process .argv 属 性 ， 一 个 字符 串 数组 ， 
它 是 在 Node 被 调用 时 使 用 的 参数 。 数 组 中 的 第 一 项 是 可 执行 的 Node， 第 二 项 是 脚本 的 名 称 。 解 
析 和 处 理 这 些 参数 只 需 循环 遍历 数组 项 并 逐一 检查 这 些 参数 。 

作为 演示 ， 我 们 来 写 一 个 名 为 args.js 的 脚本 ， 让 它 输出 process .argv 的 结果 。 大 部 分 情况 
下 你 都 不 会 关心 数组 的 前 两 项 ， 所 以 可 以 在 处 理 之 前 把 它们 slice() 挥 : 


Var Aargs = process.argv.slice!{(2); 
console.log{(args),; 


单独 调用 这 个 脚本 时 ， 你 得 到 的 是 个 空 数 组 ， 因 为 没有 传人 额外 的 参数 : 


S node args . ]S 


[] 
但 在 你 将 “hello” 和 “world” 作 为 参数 传人 时 ， 数 组 会 像 你 预期 的 那样 包含 这 些 字 符 串 : 


$s node argqds.]js hello world 
[ 'heljljo', 'world' | 


跟 所 有 终端 程序 一 样 , 你 可 以 用 引号 把 中 间 有 空格 的 参数 合成 一 个 参数 ,这 不 是 Node 的 特性 ， 
是 你 所 用 的 shell 的 (很 可 能 时 UNIX 平 台 上 的 bash 或 Windows 上 的 cmd.exe ) : 


$s node args.]Js "tobli is a ferret" 
[ 'tobi is a ferret' ] 


按照 UNIX 的 惯例 , 对 于 选项 -h 和 --help, 每 个 命令 行程 序 都 应 该 输出 使 用 指南 作为 啊 应 然 
后 退出 。 下 面 的 代码 清单 是 个 例子 ， 用 Array. forEach () 循 环 遍历 参数 并 在 回调 中 解析 它们 ， 
当 遇 到 期 望 的 选项 时 输出 使 用 指南 。 
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代码 清单 13-11 用 Array.forEach() 和 switch 块 解析 process.arev 


Var args process.argv.slice(2); | 切 掉头 两 项 , 你 不 会 对 
. 它们 感 兴趣 的 
i 
查找 -h 和 --help 
Case '-h': 
Case '--help': 
printHelp(); 
break; 
) | 在 这 里 添加 必要 的 选项 开关 
人 
| 输出 帮助 信息 ， 然 后 退 由 
function printHelp () { 
Console.logl' USdage:'),; 
console.log(' $ AwesomeProgram <options> <file-to-awesomeify>'); 
console.logr(! example:'); 
console.logl(' $$ AwesomeProgram --make-awesome not-yet.awesome'): 


process .exit(0),; 


} 

你 可 以 轻松 扩展 那个 switch 块 来 解析 额外 的 选项 。 像 commander.js .nopt .optimist 和 nomnom 
〈 仅 举 几 例 ) 这 些 社区 模块 全 部 按 它 们 目 己 的 方式 解决 这 个 问题 ,所 以 不 要 觉得 switch 块 是 解析 
参数 的 唯一 方式 。 跟 很 多 编程 中 的 问题 一 样 ， 正 确 的 解法 并 不 是 唯一 的 。 

每 个 命令 行程 序 都 要 处 理 的 另 一 个 任务 是 从 stdin 中 读 取 输入 ， 并 将 结构 化 的 数据 写 到 stdout 
中 。 我 们 来 看 一 下 在 Node 中 怎么 做 。 











13.4.2 ”人 处理 stdin 和 和 stdout 


UNIX 程 序 通 党 部 是 小 型 、 日 包含 并 专注 于 单一 任务 的 。 然 后 通过 管道 组 合 起 来 ， 将 前 一 个 
处 理 结果 交 给 下 一 个 , 直到 命令 链 的 末端 。 比 如 说 ,用 标准 的 UNIX 命令 从 给 定 的 Git 库 中 获取 唯 
-作者 的 清单 ， 可 以 将 git log、sort 和 unia 命 令 像 下 面 这 样 组 合 起 来 : 
$ git log -~-format='SaN' | sort | uniq 
Mike Cantelon 


Nathan Rajlich 
TJ Holowaychuk 


这 些 命令 是 并 行 运行 的 , 将 第 一 个 处 理 的 结 采 交 给 下 一 个 ,然后 继续 这 一 过 程 下 到 最 后 。 为 
了 遵守 这 个 管道 的 惯用 法 ，Node 提 供 了 两 个 stream 对 象 供 你 的 命令 行程 序 处 理 . 
读 输 入 数据 的 ReadStream 。 

D process.stdout 一 一 写 输出 数据 的 Writestream。 

这 些 对 象 丈 像 你 已 经 熟悉 了 的 流 接口 一 样 。 

1. 用 process .stdout 与 输出 数据 

你 每 次 调用 console.1og() 时 已 经 隐 含 着 对 process .stdout 可 写 流 的 使 用 了 。console.1og () 
痕 数 内 部 在 格式 化 完 输入 参数 后 调用 process .stdout .write()。 但 console 困 数 更 多 是 用 来 调试 和 
分 查 对 象 用 的 。 当 你 需要 将 结构 化 的 数据 写 到 stdout 中 时 ， 可 以 耳 接 调用 process .stdout .write()。 




















[Dprocess.stdin 
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假定 你 的 程序 连 上 一 个 HITP URL， 把 啊 应 写 到 stdout 中 。stream.pipe() 在 这 种 情况 下 很 
好 用 ， 代 码 如 下 所 示 : 


var http = require('http'); 





Var url = regquire('url'),; 
var target = url .parse {process .argv[2|]}): 
Var redg = http.get (target, function (res) { 


res.pipe {process.stdout).; 


i 

瞧 ! 一 个 绝对 微型 的 curl 复 制品 只 有 七 行 代码 。 还 不 赖 吧 ? 接 下 来 我 们 要 介绍 一 下 
Process .stdlno。 

2. 用 process .inj 云 取 输 入 数据 

在 从 stdin 中 读 取 数据 之 前 ， 你 必须 调用 process .stdin.resume() 表明 你 的 脚本 想 从 stdin 
中 读 取 数据 。 在 那 之 后 ，stdin 就 会 像 其 他 可 读 流 一 样 ， 在 收 到 为 外 一 个 进程 的 输出 ,或 用 户 在 终 
端 窗口 中 按键 时 发 出 gata 事 件 。 

下 面 这 段 代 码 做 的 命令 行程 序 提示 用 户 输入 年 龄 ， 然 后 再 决定 是 否 继续 执行 。 


代码 清单 13-12 一 个 提示 用 户 输入 年 龄 的 限制 年 龄 的 程序 


Var requiredAge = 18; 二 一 设 定年 龄 限制 




















z 指定 用 户 要 问答 的 问题 
Process.stdout.write('Please enter your age: '); 


将 数据 解析 process.stdin.setEncoding('utf8'); | 设置 stdin, 以 便 输 出 UTF-8 编 
为 数值 码 的 字符 串 , 而 不 是 直接 输出 


process.stdin.on('data', function (data) { 


var age = parseInt (data, 10); 缓冲 区 中 的 内 容 
上 f a N N ¥ = 
ee 如 果 用 户 输入 的 不 是 有 效 的 
数值 ， 一 条 消息 提示 
console.log('%s is not a valid number!', gaata) ,1 答 出 一 条 消息 提示 
如 果 用 户 给 } else if (age < requiredAge) { 
出 的 年 龄 不 console.log('You must be at least %d to enter, ' + 
1 Come back in %d years', 
到 18， 输 出 requiredAge, requiredAge - age); 本 四 
一 条 消息 说 ee 如 果 前 面 的 条 件 满足 了 , 继 
人 十 /一 
几 年 之 后 再 enterTheSecretDungeon ( ) ; 续 执行 
回来 ) 
， .Stdin.pause(); 关闭 stdin 之 前 ， 等 待 一 个 data 
' 事件 
process.stdin.resume(); 因为 process.stdin 开 始 处 于 暂停 
function enterTheSecretDungeon () { 状态 ， 所 以 调用 resume() 开 始 读 
console.log('Welcome to The Program :) '):; 取 输 入 


} 
3. 用 process .stderz 诊 上 断 日 志 
在 所 有 的 Node 进 程 中 ， 还 有 一 个 可 写 流 process .stderr， 它 的 表现 跟 process.stdout 
流 一 样 ， 只 是 它 是 写 到 stderr 中 的 。 因 为 stderr 通 和 常 是 调试 时 用 的 ， 不 会 用 来 发 送 结构 化 数据 ， 也 
不 会 构建 管道 ， 所 以 一 般 都 不 会 直接 访问 process .stderr， 而 是 使 用 console.error ()。 
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现在 你 已 经 熟悉 Node 中 内 置 的 stdio 流 了， 这 是 至 关 重 要 的 构建 命令 行程 序 知识 ， 接 下 来 我 
们 要 看 一 些 更 加 丰 是 多 彩 的 东西 ( 双关 语 )。 


13.4.3 ”添加 彩色 的 输出 


很 多 命令 行程 序 都 会 使 用 彩色 文本 ， 让 屏幕 上 的 内 容 更 容易 区 分 。Node 自 己 的 REPL 就 是 这 
样 做 的 ，npm 的 各 种 日 志 级 别 也 是 这 样 的 。 这 是 一 个 所 有 命令 行程 序 都 能 从 中 受益 的 奖励 特性 ， 
并 且 给 程序 添加 彩色 输出 相当 容易 ， 特 别 是 在 有 社区 醒 英 的 文 持 时 。 

1. 创建 并 编写 ANSI 转 义 码 

终 冰 中 的 颜色 是 由 ANSI 转 义 码 (ANSI 指 美国 国家 标准 委员 会 ) 产生 的 。 这 些 转 义 人 码 只 是 写 
到 stdout 中 的 简单 文本 序列 ， 对 终 病 有 特殊 的 含义 一 一 它们 可 以 改变 文本 的 颜色 ， 光 标的 位 置 ， 
发 出 蜂 鸣 声 等 等 。 

我 们 先 从 稍 单 的 开始 。 在 你 的 脚本 中 输出 一 个 绿色 的 单词 "hello , 只 用 一 行 console.1og () 
就 行 了 : 

console.log('\033[32mhello\033[39m'); 

如 条 仔细 看 一 下 ， 你 会 发 现 单词 “hello ”两 边 都 有 一 些 看 起 来 很 奇怪 的 字符 。 这 让 人 乍 一 看 
可 能 会 比较 迷糊 ， 但 实际 上 相当 简单 。 图 13-4 把 绿色 的 “hello” 字 符 串 分 解 成 了 三 部 分 。 


\033[32m hello \033[39m 


ANSI 转 义 码 各 诉 终 病 ”中 间 的 文本 部 分 ANSI 闫 色 “ 重 置 ” 码 让 
后 续 文 本 都 是 绿色 的 ”会 显示 为 绿色 的 终端 用 回 默认 的 文本 颜色 


图 13-4 用 ANSI 转 义 码 输出 绿色 的 “hello” 


终端 可 以 识别 的 转 义 码 有 很 多 , 并 且 大 多 数 开 发 人 员 都 不 太 有 时 间 去 把 它们 全 记 下 来 。 感 谢 
Node 社 区 ， 又 一 次 推出 了 很 多 模块 来 解救 我 们 ， 比 如 colors.js、clicolor 和 ansijs， 证 颜色 的 使 用 
忒 得 简单 又 有 趣 。 

Windows 上 的 ANSI 转 义 码 从 技术 角度 讲 ，Windows 和 它 的 命令 提示 符 
(cmd.exe ) 并 不 支持 ANSI 转 义 码 。 不 过 我 们 很 幸运 ， 当 你 的 脚本 在 Windows 上 将 转 义 
码 写 到 stdout 中 时 ，Node 会 帮 你 解释 它们 ,并 调用 相应 的 Windows 函 数 产生 相同 的 结果 。 

你 知道 就 行 了 ， 在 写 Node 程 序 时 并 不 需要 关心 这 个 。 

2. 用 ansi.js 格 式 化 前 景色 

我 们 来 看 一 下 ansi.js ( https://github.com/TooTallNate/ansi.js )， 你 可 以 用 npm install ansi 
。 这 个 模块 好 在 它 只 是 在 原始 的 ANSI 代 码 上 封 了 湾 注 的 一 层 ， 跟 其 他 的 颜色 模块 (它们 一 
只 能 处 理 一 个 字符 串 ) 相 比 给 了 你 很 大 的 灵活 性 。 在 ansijs 中 ， 设 定 流 的 模式 ( 比如 “bold”)， 
们 就 会 一 直 保 持 ， 直 到 被 reset () 调用 清除 。ansi.js 还 有 一 个 额外 的 奖励 特性 ， 它 是 第 一 个 支 
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持 256 色 终端 的 模块 ， 并 且 它 能 把 CSS 颜 色 码 (比如 证 F0000 ) 转换 成 ANSI 颜色 人 码 。 

ansi.js 模 块 使 用 了 cursor 的 概念 ,实际 上 只 是 包装 了 一 个 可 写 流 实例 , 提供 了 很 多 回流 中 写 和 人 
ANSI 码 的 便利 也 数 ， 这 些 函 数 全 都 支持 链 式 调用 。 要 输出 绿色 的 文本 “hello”， 用 ansi.js 的 语法 
可 以 写成 : 


Var ansi <= require('ansi'); 
Var Cursor = ansi (process.stdout); 











CUTSOT 
.foq.gqreen!() 
.write!(l'Hello') 
.fog,.reset!) 
.WIrite('\n'); 
这 里 可 以 看 到 ansi.js 的 用 法 ,首先 要 从 可 写 流 中 创建 一 个 cursor 实 例 。 因 为 你 要 对 程序 的 输 
出 着 色 ， 所 以 要 将 cursor 用 的 process .stdqout 作 为 可 写 流 传人 。 有 了 cursor 之 后 ， 你 可 以 
调用 它 提 供 的 所 有 方法 来 修改 在 终 病 中 演 染 文本 的 方式 。 这 个 例子 中 的 结果 跟前 面 那 个 
console.1o0g() 的 输出 一 样 : 
口 cursor.fg.green() 将 前 景色 设 为 绿色 ; 
口 cursor.write('Hello' ) 用 绿色 将 文本 “Hello” 写 到 终 闹 中 ，; 
口 cursor.fg.reset() 将 前 景色 重 置 为 默认 值 ; 
口 cursor.write('\n') 以 一 个 新 行 结 
用 cursor 编 程 调整 输出 是 一 种 改变 凑 色 的 人 简洁 接口 。 
3. 用 ansi.js 格 式 化 背景 色 
ansi.js 模 块 也 支持 背景 色 。 要 设 定 背 景色 ， 把 前 面 调用 中 的 fg 换 成 bg。 比如 将 背景 色 设 定 为 


红色 ， 可 以 调用 cursor .bg.red()。 
我 们 来 包装 一 个 简单 的 程序 ， 在 终端 中 输出 这 本 书 的 彩色 标题 ， 如 图 13-$ 所 示 。 





























个 口 日 3. bash ee” 
~ f node ansi-title.]s 


Node .15 in Actio 


Nathan Rajlich 
~ # 





图 13-5 ”ansi-title.js 脚 本 用 不 同 的 颜色 输出 本 书 的 名 称 和 作者 


输出 这 些 深 亮 颜色 的 代码 很 索 琐 , 但 很 直接 ， 因 为 每 个 函数 调用 都 直接 对 应 到 了 写 到 流 中 的 
转 义 人 码 上 。 下 面 清单 中 有 两 行 初 始 化 代码 ,然后 是 一 个 非常 长 的 函数 调用 链 , 最 后 将 闫 色 人 码 和 字 
符 串 写 到 process .stdout 中 。 
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Node 生 态 系 统 


本 章 内 容 

口 寻找 Node 的 在 线 帮助 

口 用 GitHub 协 作 Node 开 发 

口 用 Node 包 管理 带 发 布 你 的 作品 





要 从 Node 开 发 中 获得 最 大 收益 , 你 得 知 拓 到 哪里 寻求 帮助 , 以 及 如 何 跟 社 区 中 的 其 他 人 分 这 
你 的 成 果 。 

跟 大 多 数 开源 社区 一 样 , Node 和 相关 项 目的 开发 都 是 通过 在 线 协作 完成 的 。 很 多 开发 人 员 合 
作 提 交 和 审核 代码 ， 做 项 目 文档 ， 报 告 bug。 当 开发 人 员 准 备 好 发 布 Node 的 新 版 本 时 ， 会 把 它 发 
布 在 Node 的 官网 上 。 当 一 个 值得 发 布 的 第 三 方 模块 被 创建 出 来 时 ， 可 以 把 它 发 布 到 npm 库 中 ， 这 
样 其 他 人 安 半 起 来 更 容易 。 在 线 资源 为 你 提供 了 使 用 Node 及 相关 项 目 所 需 的 文 持 。 

图 14-1 阐 明了 如 何 用 在 线 资 源 做 Node 相 关 的 开发 、 分 发 和 支持 。 
















用 Github 创 建 项 目 
并 开展 协作 


来 自用 户 交 互 的 反馈 


# 


用 Google 群 组 、IRC 
和 GitHub 问 题 
跟 蹊 单 支 持 项 目 








在 package.json 
中 增长 版 本 号 


用 npm 发 布 项 目 


< 


用 户 用 npm 更 新 
图 14-1 ” Node 相关 的 项 目 是 通过 在 线 协作 创建 的 ， 一 般 是 通过 GitHub 网 站 。 人 然后 发 布 
到 npm 中 ， 通 过 在 线 资 源 提供 文档 和 支持 
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在 协作 之 前 ,你 很 可 能 先知 要 文 持 , 所 以 我 们 先 来 看 一 下 网 上 有 了 哪些 地 方 可 以 为 你 提供 帮助 。 


14.1 给 Node 开发 人 员 的 在 线 资源 


Node 的 世界 日 新 月 异 , 所 以 只 能 在 网 上 找到 最 新 的 参考 资料 。 你 将 面 对 数 不 清 的 网 站 、 在 线 
讨论 组 和 聊天 室 ， 并 从 中 找到 你 需要 的 信息 。 


14.1.1 Node 和 模块 的 参考 资料 


表 14-1 列 出 了 一 些 与 Node 相 关 的 在 线 参考 资料 和 资源 。 和 学 习 Node API 和 了 解 可 用 的 第 三 方 模 
块 最 实用 的 网 站 分 别 是 Node.js 和 npm 的 站 页 。 


表 14-1 实用 的 Node.js 参 考 资料 














资 产 URL 
Node.js 首 页 http://nodejs.org/ 
最 新 的 Node.js 核 心 文档 http://nodejs.org/api/ 
Node.js 博 客 http://blog.nodejs.org/ 
Node.js 职 位 公告 板 http://jobs.nodejs.org/ 
Node.js 包 管理 器 (npm) 的 首页 http://npmys.org/ 





当 你 答 试 用 Node， 或 它 的 任何 内 置 模块 做 些 东西 时 ，Node 的 首页 是 一 个 宝贵 的 资源 。 这 个 
网 站 〈 如 图 14-2 所 示 ) 有 Node 框 架 的 完整 文档 ， 包 括 它 的 每 个 API。 你 总 能 在 这 个 网 站 上 找到 最 
新 版 本 的 Node 文 档 。 官 方 博客 还 记录 了 Node 的 最 新 进展 ， 分 享 重 要 的 社区 新 闻 。 这 里 甚至 还 有 


个 职位 公告 板 。 











OA Query String Node.js v0.8 x 


C 省 nodejs.org/docs/latest/api/querystring.htm 


querystring.stringify(ob]j, [Sep], [eq]) 


Serialize an object to a query string. Optionally override the default separator ( '&" )and assignment ( '=" ) 
characters. 
Example: 

querystring.stringify(C{ foo: 'bar', baz: ['qux', ‘'quux'], corge: '' }) 

// returns 

"foo=bar&baz=qux&baz=qdUUX&COorge=" 

querystringestringifyC{tfo0: ‘bar”: bazs "qux Fs >> "i ) 


tfFr ye ' 
TOO., DaT, DAaZ ,QUX 


querystring.parsel(str, [Sep], [eq], [options]) 


Deserialize a query string to an object. Optionally override the default separator ( '&"' )and assignment ( "=" ) 
characters. 


图 14-2 ”除了 提供 与 Node 相 关 的 实用 资源 的 链接 ，nodejs.org 还 提供 了 Node 各 个 版 本 
API 的 权威 文档 
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如 果 你 要 选 购 第 三 方 的 功能 ， 应 该 去 npm 库 的 搜索 页 面 。 你 可 以 用 关键 字 在 npm 中 的 上 千 个 
模块 中 进行 搜索 。 如 果 你 找到 了 一 个 你 想 要 签 出 的 模块 ,点击 模块 的 名 字 进 入 它 的 详细 页 面 ， 你 
会 在 那里 看 到 指向 模块 项 目 主 页 的 链接 ， 如果 有 的 话 ， 以 及 依赖 该 模块 的 其 他 npm 包 ， 这 个 模块 
的 依赖 项 ， 跟 哪个 版 本 的 Node 兼 容 ， 以 及 版 权 信息 。 

无 论 如 何 , 这 些 网 站 可 能 无 法 回答 你 关于 如 何 使 用 Node 或 其 他 第 三 方 模块 的 所 有 问题 。 我 们 
册 去 看 一 些 可 以 给 予 你 更 大 带 助 的 其 他 地 方 。 








14.1.2 “Google 群 组 


Node 和 一 些 流 行 的 第 三 方 模块 , 包括 npm、Express、node-mongodb-native 和 Mongoose 已 经 有 
Google 和 群 组 了 。 

Google 群 组 适合 讨论 困难 的 , 或 有 深度 的 问题 。 比 如 说 , 如 果 你 不 知道 如 何 用 node-mongodb- 
native 模 块 删除 MongoDB 文 档 , 可 以 到 node-mongodb-native 的 Google 和 群 组 ( https://groups.google.com/ 
forum/?3fromgroups#!forum/node-mongodb-native ) 中 搜 一 下 ， 看 看 其 他 人 有 没有 相同 的 问题 。 如 
果 没 有 人 解决 过 你 遇 到 的 问题 ， 接 下 来 你 应 该 加 入 Google 群 组 提交 你 的 问题 。 在 Google 群 组 上 ， 
你 可 以 发 长 长 的 帖子 ， 这 对 于 复杂 问题 很 有 帮助 ， 因 为 这 样 你 才能 充分 地 解释 它 。 

这 里 没有 包含 与 Node 相 关 的 所 有 Google 群 组 的 清单 。 可 能 会 有 些 项 目 文档 提 到 它们 , 但 通常 
你 只 能 在 网 上 搜 一 下 。 比 如 说 ， 你 可 以 在 Google 上 搜 “ 模 块 名 称 node.js google group”， 看 看 有 没 
有 这 个 第 三 方 模块 的 Google 群 组 。 

Google 群 组 的 缺点 时 你 通常 要 等 上 几 个 小 时 ,或 几 天 才能 看 到 反馈 ， 这 取决 于 Google 群 组 。 
对 于 需要 快速 回复 的 简单 问题 ， 你 应 该 考虑 找 个 在 线 聊 天 室 ， 通常 能 很 快 得 到 答案 。 








14.1.3 1IRC 


互联 网 中 继 聊 天 (IRC ) 的 创建 可 以 回溯 到 1988 年 ， 尽 管 有 人 和 觉得 这 是 个 老 古 董 ， 但 它 依然 
生机 劲 发 ， 并 且 如 果 你 想 问 开 源 软件 方面 的 简单 问题 ， 它 是 得 到 答 采 的 最 佳 在 线 途 答 。IRC 聊 天 
室 被 称 为 频道 , Node 和 各 种 第 三 方 模块 都 有 目 己 的 频道 。 你 也 找 不 到 跟 Node 相 关 的 IRC 频 道 的 清 
单 ， 但 第 三 方 模块 有 时 会 在 它们 的 文档 中 提 到 目 己 的 IRC 频 道 。 

要 在 IRC 上 得 到 答案 ， 先 连接 到 IRC 网 络 ( http://chatzilla.hacksrus.com/fag/#connect )， 进 入 相 
应 的 频道 ， 发 送 你 的 问题 。 出 于 对 频道 中 那些 朋友 的 革 重 ,你 最 好 事先 在 网 上 搜 一 下 ， 别 问 那 种 
一 下 子 就 能 找到 答 肥 的 问题 。 

如 果 你 刚 接 触 IRC， 最 容易 的 连接 办 法 是 用 基于 Web 的 客户 问 。 大 部 分 与 Node 相 关 的 IRC 频 
道 都 在 Freenode 上 ， 这 个 IRC 网 络 有 个 Web 客 户 病 http://webchat.freenode.net/。 要 加 入 频道 ， 在 连 
接 表 单 中 填 上 相应 的 名 称 。 你 不 需要 注册 ， 并 且 你 可 以 输入 任何 想 要 的 昵称 。( 如 果 你 选 的 名 字 
已 经 被 其 他 人 占用 了 ， 你 的 昵称 后 面 会 加 上 一 个 下 划 线 (_) 以 示 区 别 。) 

点 击 连接 之 后 ， 你 就 能 进入 频道 ， 跟 房间 中 的 其 他 用 户 一 样 出 现在 右 侧 栏 的 用 户 列 表 中 。 
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14.1.4 ” ”GitHub 问题 列表 


如 果 是 在 GitHub 上 开发 的 项 目 ， 你 还 可 以 到 项 目的 GitHub 问 题 列表 上 找 找 问题 和 解决 方案 。 
要 访问 问题 列表 ， 先 进入 项 目的 GitHub 主 页 ， 扣 击 Issues 标 签 柱 。 你 可 以 用 搜索 框 查找 跟 你 的 问 
题 相关 的 问题 。 图 14-3 中 是 一 个 问题 列表 的 示例 。 





Node module 
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图 14-3 ”对 于 GitHub 上 的 项 目 而 言 ， 如 果 你 党 得 目 己 发 现 了 项 目 代码 中 的 问题 ， 问 题 
列表 可 以 帮 到 你 


如 打 找 不 到 可 以 解决 你 的 问题 的 问题 ， 并 且 你 认为 是 项 目 代 码 中 的 bug 导 致 了 问题 的 出 现 ， 
可 以 点 击 问题 列表 页 面 上 的 New Issue 按 钮 提交 这 个 bug, 项 目的 维护 者 可 以 在 那个 问题 页 面 上 回 
复 你 ， 或 者 解决 这 个 问题 ， 或 者 提出 一 些 疑 问 以 便 了 解 问题 出 现 的 原因 。 


问题 跟踪 单 不 是 支持 论坛 在 项 目的 GitHub 问 题 跟踪 单 开 一 个 普通 的 支持 性 问题 可 
能 不 大 合适 , 当然 , 这 取决 于 具体 项 目 。 如果 项 目 为 用 户 设置 了 获取 一 般 性 支持 的 途径 ， 
比如 Google 群 组 , 则 通常 是 这 种 情况 。 你 最 好 先 看 一 下 项 目的 README 文 件 , 看 看 它 是 
否 有 关于 一 般 性 支持 或 问题 的 偏好 说 明 。 


现在 你 知道 到 哪里 去 提交 项 目的 问题 了 , 接 下 来 我 们 要 讨论 GitHub 的 非 支 持 性 角色 一 一 它 是 
大 部 分 Node 开 发 协作 所 倚重 的 网 站 。 

















14.2 GitHub 


GitHub 称 得 上 是 开源 世界 的 重心 ， 对 Node 开 发 人 员 来 说 至 关 重 要 。 GitHub 服 务 提供 商 提 供 
了 Git 服 务 ， 这 是 一 个 强大 的 版 本 控制 系统 (VCS )， 你 还 可 以 通过 Web 界 面 轻松 浏览 Git 库 。 开 源 
项 目 可 以 免费 使 用 GitHub 。 
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Git Git VCS 很 受 开 源 项 目的 青睐 。 它 是 一 个 分 布 式 的 版 本 控制 系统 (DVCS )， 
跟 Subversion 和 很 多 其 他 的 VCS 不 同 ， 你 不 一 定 非 要 连接 到 服务 器 上 。Git 是 在 2005 年 发 
布 的 ,当时 是 受到 了 一 个 叫做 BitKeeper 的 特有 VCS 的 启发 。 BitKeeper 的 发 布 者 授权 Linux 
内 核 开发 团队 自由 使 用 该 软件 ,但 因为 怀疑 该 团队 的 成 员 试 图 探 完 BitKeeper 的 内 部 工作 
机 制 ,随后 又 收回 了 授权 ,Linux 的 缔造 者 Linus Torvalds, 决定 创建 一 个 功能 相似 的 VCS ， 
个 把 月 后 ，Linux 内 核 开 发 团队 用 上 了 Git。 


除了 提供 Git 访 问 ，GitHub 还 为 项 目 准 备 了 问题 跟踪 、 维 基 和 和 Web 页 面 服务 等 功能 。 因 为 npm 
库 中 的 大 多 数 Node 项 目 都 在 GitHub 上 , 所 以 了 解 GitHub 的 使 用 对 你 充分 利用 Node 开 发 很 有 帮助 。 
在 GitHub 上 很 多 事情 做 起 来 都 很 方便 ， 浏 览 代 码 、 检 查 未 解决 的 bug， 如 果 你 想 ， 还 可 以 贡献 解 
决 问题 的 办 法 ， 编 写 文 档 。 

GitHub 的 另 一 个 用 途 是 监测 项 目 。 受 到 监测 的 项 目 发 生变 化 时 会 给 你 发 送 通知 。 监 测 项 目的 
人 数 经 党 被 用 来 评判 项 目的 普及 程度 。 

GitHub 可 能 很 强大 ， 但 你 要 怎么 用 它 呢 ?” 接 下 来 我 们 就 要 深入 人 研究 一 下 。 





14.2.1 GitHub 入 门 


当 你 有 了 一 个 基于 Node 的 项 目 或 第 三 方 模块 的 想法 时 , 很 可 能 要 在 GitHub 上 设置 个 账号 (如 
果 你 还 没有 )， 以 便 访问 Git 服 务 。 设 置 好 后 可 以 添加 项 目 ， 我们 下 一 节 再 讲 这 个 。 

因为 GitHub 要 用 Git， 在 继续 GitHub 之 前 ， 需 要 先 配 置 Git。 谢 天 谢 地 ， GitHub 分 别 为 Mac、 
Windows 和 Linux 准 备 了 帮助 页 面 (https://help.github.com/articles/set-up-git )， 帮 你 把 Git 配 置 好 。 
Git 配 置 好 之 后 , 你 还 需要 配置 GitHub, 在 它 的 网 站 上 注册 , 并 提供 一 个 安全 壳 ( SSH ) 公 钥 。SSH 
秘 钥 可 以 确保 你 跟 GitHub 交 互 的 安全 性 。 

这 些 步骤 在 下 一 节 都 有 详细 的 介绍 。 注 意 , 这 些 步骤 只 需要 做 一 次 , 不 是 每 次 往 GitHub 中 添 
加 项 目 时 都 需要 。 

1. Git 配 置 和 GitHub 注 册 

要 用 GitHub， 得 配置 好 你 的 Git 工 具 。 你 需要 用 下 面 这 两 条 命令 提供 你 的 姓名 和 邮箱 地 址 : 


git config ~-global user.name "Bob Dobbs" 
dit config --global user.email subgenius@example.com 


接 下 来 在 GitHub 网 站 上 注册 。 访 问 注 册页 面 ( https://github.com/ signup/free )， 填 好 表单 ， 点 
击 创建 账号 。 

2. 给 GitHub 一 个 SSH 公 和 钥 

注册 完 之 后 ， 你 需要 给 GitHub 一 个 SSH 公 和 钥 〈https:/help.github.comyarticles/generating- 
ssh-keys )。 你 将 用 这 个 公 钥 对 Git 事 务 进 行 验证 。 按 照 下 面 这 些 步骤 操作 : 

(1) 在 浏览 套 中 访问 https:Wgithub.comy/settings/ssh ; 

(2) 点 击 添加 SSH 秘 钥 。 

到 这 里 后 ,你 需要 做 什么 就 取决 于 你 使 用 的 操作 系统 了 。GitHub 会 检测 出 你 的 操作 系统 ， 并 
给 出 相应 的 指令 。 
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14.2.2 添加 一 个 项 目 到 GitHub 中 


在 GitHub 上 安顿 好 之 后 ， 你 就 可 以 往 自己 的 账号 下 添加 项 目 ， 提 交 内 容 了 。 
为 此 你 需要 先 为 项 目 创 建 一 个 GitHub 库 ， 稍 后 详细 介绍 。 之 后 在 你 的 本 地 机 融 上 创建 一 个 
Git 库 ， 在 把 作品 推送 到 GitHub 库 之 前 你 就 在 那里 完成 它 。 图 14-4 列 出 了 这 个 过 程 。 














互联 网 










4. 从 Git 推 送 
到 GitHub 


1. 创建 
GitHub 库 




















2. 设 置 空 3. 把 文件 添加 
的 Git 库 到 Git 库 中 








图 14-4 ”把 Node 项 目 添 加 到 GitHub 中 所 知 的 步 缀 


你 还 可 以 用 GitHub 的 Web 界 面 查看 项 目 文件 。 

1. 创建 一 个 GitHub 库 

在 GitHub 上 创建 库 需 要 下 面 这 些 步 又 : 

(1) 在 Web 浏 览 硕 中 登入 github.com ; 

(2) 访问 https://github.com/new; 

(3) 填 好 结 来 表单 ， 描 述 你 的 库 ， 人 然后 点 击 创建 库 ; 

(4) GitHub 为 你 的 项 目 创建 了 一 个 空 日 的 Git 库 和 一 个 问题 列表 ; 

(5) GitHub 会 给 出 你 用 Git 把 代码 推送 到 GitHub 中 所 需 的 步骤 。 

理解 这 些 步 又 做 了 什么 会 对 你 有 帮助 的 ， 所 以 我 们 会 做 一 个 例子 来 前 明 Git 最 基本 的 用 法 。 

2. 设置 一 个 空白 的 Git 库 

要 往 GitHub 中 添加 一 个 示例 项 目 , 需要 先 创 建 一 个 Node 模 块 的 例子 。 我们 要 创建 一 个 能 缩短 
URL 的 模块 ，node-elf。 

先 用 下 面 的 命令 给 项 目 创 建 一 个 临时 目录 : 


mkdir -p ~/tmp/node-elf 
CQ ~/tmp/node-elt 
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为 了 把 这 个 目录 当 作 Git 库 ， 需 要 输入 下 面 的 命令 ( 它 会 创建 一 个 .git 目 录 存 放 库 的 元 数据 ): 
vit irit 
3. 向 Git 库 中 添加 一 个 文件 
空白 库 设 置 好 了 ,你 可 能 想 添 加 一 些 文件 进去 。 作 为 例子 , 我们 会 添加 一 个 包含 URL 缩 短 逻 
辑 的 文件 。 把 下 面 的 代码 放 到 这 个 目录 下 名 为 index.js 的 文件 里 。 
代码 清单 14-1 缩短 UREL 的 Node 模 块 


exports.initPathData = function(pathData) { 
由 shorten() 和 expand() 


pathData = (pathData) ? pathData : {}; Se 和 本 
AR 3 5 迷 
DathData.count = (pathData.count) ? pathData.count : 0; 隐 含 调用 的 初始 化 函数 
pathData.map = (pathData.map) ? pathData.map : {}; 
} 
exports.shorten = function(pathData, path) { 接受 一 个 “path” 字符 串 ， 并 返回 
expDorts .1n1ItPathDatal(PDathData) ，; _ , 
一 个 跟 它 对 应 的 短 化 URL 
PathData.count++; 


pathData.maplpathData.count] = path,; 
return pathData.count.toString(36); 
} 


exports.expand = function(pathData, shortened) { 
exports.initPathData (pathData); 
Var pathIindex = parselInt (shortened, 36); 
return pathData.maplpathIindex]; 

} 


接 下 来 ， 让 Git 知 道 你 想 把 这 个 文件 放 到 库 中 。git 的 add 命 令 跟 其 他 的 版 本 控制 系统 不 一 样 。 
它 不 是 把 文件 添加 到 库 中 ， 而 是 添加 到 Git 的 临时 区 。 你 可 以 把 临时 区 看 成 是 一 个 检查 表 ， 指 明 
新 添加 的 文件 ， 或 你 修改 过 的 文件 ， 要 把 它们 包含 在 库 的 下 一 次 修订 中 : 

git add index.js 

这 样 Git 就 知道 它 应 该 跟踪 这 个 文件 。 如 果 你 想 ， 还 可 以 癌 临 时 区 添加 其 他 文件 ， 但 现在 有 
这 一 个 文件 就 够 了 。 

要 让 Git 知 道 你 想 在 库 中 做 个 新 修订 ， 包 含 你 放 在 临时 区 中 修改 过 的 文件 ， 需 要 用 commit 命 
令 。 跟 其 他 VCS 中 一 样 ，commit 命 令 可 以 用 命令 行 选项 -m 指 定 一 条 消息 ,描述 新 修订 所 做 的 修改 : 

人 RD 

你 本 地 机 如 中 的 库 现在 已 经 包含 新 的 修订 了 。 要 查看 库 修改 的 清单 ， 请 输入 下 面 的 命令 : 

git log 

4. 从 Git 推 送 到 GitHub 

如 果 这 时 候 你 的 机 各 突然 被 雷 辟 了 ,， 那 所 有 的 工作 就 要 和 于 了。 为 了 防范 这 种 突 发 性 事件 ,并 
充分 利用 GitHub 的 Web 界 面 提 供 的 好 处 , 你 得 把 本 地 Git 库 中 的 修改 送 到 你 的 GitHub 账 号 下 。 但 在 
做 这 件 事 情 之 前 ， 要 先 让 Git 知 道 应 该 把 修改 送 到 哪里 去 。 为 此 你 需要 添加 一 个 Git 远 程 库 。 它 们 
被 称 为 Temotes。 


接受 之 前 短 化 的 URL 并 
返回 展开 的 URL 
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下 面 这 条 命令 就 是 往 你 的 库 上 添加 GitHub 远 程 库 的 。 用 你 的 用 户 名 替换 掉 username， 注 意 
node-elf.git, 这 是 项 目的 名 称 : 





git remote add origin git@github.com:username/node-elf.git 

远程 库 添 加 好 ， 现 在 你 可 以 把 修改 发 送 给 GitHub 了 。 在 Git 的 术语 表 中 ， 发 送 修改 被 称 为 库 
推送 。 在 下 面 的 命令 中 , 你 告诉 Git 把 你 的 工作 推送 到 前 面 定 义 的 远程 库 origin 中 。 所 有 Git 库 都 可 
以 有 一 或 多 个 分 文 ， 从 概念 上 区 分 库 中 的 不 同 工 作 区 。 你 要 把 工作 推送 到 分 文 master 中 : 

git push ~-u origin master 


推送 命令 中 的 选项 -u 告 诉 Git 这 个 远程 库 是 上 游 的 远程 库 和 分 文 。 上 游 远程 库 是 默认 使 用 的 





远程 库 。 
在 做 过 一 次 带 -u 的 推送 后 ， 将 来 再 推送 时 用 下 面 这 条 命令 就 行 了 ， 它 更 好 记 : 
git push 


如 有 果 到 GitHub 上 去 刷新 你 的 库 页 面 ， 应 该 能 见 到 你 的 文件 了 。 创 建 一 个 模块 并 把 它 放 到 
GitHub 上 是 重用 它 的 快捷 办 法 。 比 如 说 ， 如 果 你 想 在 项 目 中 使 用 你 的 样本 模块 ， 可 以 像 下 面 这 个 
例子 一 样 输入 这 些 命令 : 

mkdir ~ tmpymy_ project/node modules 

cd ~/tmp/my_project/node modules 


git clone https://github.com/mcantelon/node-elf.git el 
SQ ， 


然后 用 require('elf' ) 就 可 以 使 用 这 个 模块 了 。 注意 , 在 克隆 一 个 库 时 , 命令 行 中 的 最 后 
一 个 参数 是 你 要 把 它 克 隆 到 哪里 去 的 目录 名 。 

你 现在 已 经 知道 如 何 把 项 目 添加 到 GitHub 中 了 , 包括 如 何在 GitHub 上 创建 一 个 库 ; 如 何在 你 
的 机 需 上 创建 Git 库 ， 并 把 文件 汐 加 到 里 面 ; 以 及 如 何 把 你 的 机 需 上 的 库 推 送 到 GitHub 中 。 网 上 
有 很 多 优秀 的 资源 可 以 文 持 你 继续 前 行 。 如 采 你 想 寻 求全 面 的 Git 使 用 指导 , Scott Chacon, GitHub 
的 创建 者 之 一 ， 写 了 一 本 非常 全 面 的 书 ，Pro Git， 你 可 以 买 来 看 看 ， 或 者 在 线 免 费 阅 读 
( http://progit.org/ )。 如 果 你 更 襄 欢 手把手 教学 的 方式 ，Git 冒 方 网 站 的 文档 页 里 列 出 了 帮 你 起 步 的 
教程 ( http://git-sem.com/documentation )。 


























14.2.3 ”用 GitHub 协 作 


现在 你 已 经 知道 如 何 从 头 开 始 创 建 GitHub 库 了 ， 接 下 来 我 们 看 看 如 何 用 GitHub 跟 其 他 人 协作 。 

假定 你 正在 用 一 个 第 三 方 模块 ， 并 且 遇 到 了 bug。 你 可 能 会 去 检查 这 个 模块 的 源码 并 找 出 解 
决 办 法 , 然后 你 可 能 会 给 代码 的 作者 发 封 邮件 , 介绍 你 的 解决 办 法 , 并 把 修改 过 的 文件 作为 附件 。 
但 这 样 那 位 作者 还 需要 做 些 繁 琐 的 工作 。 他 /她 只 能 比较 你 的 文件 和 最 新 的 代码 ， 然 后 再 把 修订 
从 你 的 文件 中 拿 出 来 放 到 最 新 的 代码 中 。 但 如 果 这 位 作者 用 了 GitHub， 你 可 以 克隆 这 个 项 目 库 ， 
做 些 修改 ， 然 后 通过 GitHub 的 bug 修 订 通 知 作者 。GitHub 会 在 Web 页 面 上 展示 你 的 代码 和 你 复制 
的 版 本 的 差异 ， 并 且 如 果 bug 修 订 可 以 接受 的 话 ， 只 需 点 击 一 次 鼠标 就 能 把 你 的 修订 合并 到 最 新 
的 代码 中 。 
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按 GitHub 的 说 法 ， 复 制 一 个 库 被 称 为 分 又 〈forking )。 对 项 目 分 又 后 ， 你 可 以 在 你 的 副本 上 
做 任何 事情 ,不 用 担心 对 原始 库 造 成 影响 。 分 又 不 需要 得 到 原作 者 的 许可 : 任何 人 都 可 以 分 又 任 
何 项 目 ， 并 把 他 们 的 贡献 提交 回 原始 项 目 中 。 原 作者 可 能 不 会 认可 你 的 贡献 , 但 你 仍然 可 以 拥有 
你 自己 的 修订 版 , 继续 独立 地 维护 和 增强 它 。 如 果 你 的 分 又 越 来 越 受 欢迎 ， 其 他 人 可 能 也 会 分 又 
你 的 分 又 ， 并 贡献 他 们 上 自己 的 成 果 。 

你 对 分 义 做 出 修改 后 ， 可 以 用 一 个 拉动 (pull ) 请 求 把 这 些 修 改 提 交 给 原作 者 ， 这 是 一 个 询 
问 库 作者 是 否 拉动 变化 进来 的 消息 。 拉 动 ， 按 Git 的 说 法 ， 意 是 时 从 分 支 中 引入 工作 ， 并 合并 到 
自己 的 工作 中 。 图 14-5 描 绘 了 GitHub 协 作 的 场景 。 


站 
GitHub 库 
页 献 者 B 























@ 一 个 页 献 者 A 创建 了 一 个 GitHub 库 。 贡 献 者 A 让 朋友 B 参 与 到 项 目 中 来 帮忙 。 


贡献 者 C 决 定 往 项 目 中 添加 一 个 功能 ， 创 建 了 分 支 1。 当 原始 库 被 更 新 时 ， 分 
支 的 贡献 者 们 可 以 “拉动 ”变化 ， 更 新 他 们 分 支 的 代码 。 页 献 者 C 曾 试 着 让 页 
献 者 A 和 B 接 受 他 的 功能 ， 但 他 们 没有 ， 因 为 他 们 对 项 目 有 不 同 的 定位 ， 所 以 
页 献 者 C 的 功能 只 能 留 在 他 目 己 的 分 支 里 。 


贡献 者 D 在 这 个 Web 框 架 里 发 现 了 一 个 bug， 她 决定 伦 些 时 间 来 修订 它 ， 所 以 
创建 了 分 又 2。 页 献 者 D 的 bug 修 订 被 页 献 者 A 和 B 接 受 了 ， 无 论 如 何 ， 她 提 
交 了 “拉动 请 求 ” 到 原始 库 ， 结 采 经 过 页 献 者 A 和 B 的 评审 后， 她 的 代码 就 
被 “ 拉 到 原始 库 中 了 。 


图 14-$ ”典型 的 GitHub 开 发 场景 


现在 我 们 来 看 一 个 为 了 协作 对 GitHub 库 进行 分 义 的 例子 。 这 个 过 程 如 图 14-6 所 示 。 




















分 又 0 送 给 创建 拉 
GitHab 库 “| 隆 到 本 地 | | 提交 修改 
1 









图 14-6 “通过 分 又 在 GitHub 上 进行 协作 的 过 程 
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分 又 把 GitHub 上 的 库 复 制 到 你 的 账号 下 ， 开 局 了 协作 的 过 程 ( 称 为 分 义 ) (A )。 然 后 你 把 
分 叉 库 克隆 到 目 己 的 机 需 上 《〈B )， 对 它 进 行 修改 ,提交 这 些 修改 (C ), 把 你 的 工作 推送 会 GitHub 
(CD )， 并 给 原始 库 的 所 有 者 发送 一 个 拉动 请 求 ， 让 他 们 考虑 下 你 的 修改 (E)。 如 采 他 们 想 把 你 的 
修改 纳入 他 们 的 库 中 ， 他 们 就 会 认可 你 的 拉动 请 求 。 

比如 说 你 想 分 义 本 芋 前 面 创建 的 node-elf 孟 ， 深 加 代码 输出 检 岂 的 版 本 号 。 这 样 模块 的 用 户 
就 可 以 肯定 他 们 用 的 是 正确 的 版 本 了 。 

首先 登入 GitHub， 进 入 这 个 库 的 主页 : https://github.com/mcantelon/node-elf。 点 击 页 面 上 的 
分 又 〈Fork ) 按钮 复制 该 库 。 结 果 页 面 跟 原始 库 的 页 面 类 似 ， 不 过 在 库 名 下 有 类 似 “forked from 
mcantelon/node-elf ”的 说 明 。 

分 又 后 ， 接 下 来 是 把 库 元 隆 到 你 的 机 各 上 ， 进 行 修改 ， 把 修改 推送 给 GitHub。 下 面 的 命令 
会 对 node-elf 库 做 这 些 操作 : 

mkdir -p ~/tmp/forktest 

CQ ~/tmp/forktest 

Git clone git@github.com: chickentown/node-elf.git 

cd node-elftf 

echo "exports.version = '0.0.2';" >> index.]s 

git add index.1s 


git commit -m "Added specification of module version." 
git push origin master 


完成 修改 的 推送 后 , 在 分 又 库 的 页 面 上 点 击 拉动 请 求 ( Pull Request ), 输入 标题 和 消息 主体 ， 
描述 你 的 修改 。 点 击发 送 拉动 请 求 ( Send Pull Request )。 图 14-7 是 包含 常见 内 容 的 截屏 。 




















chickentown opened this pull request just now 
Added specification of module version 


So folks can make sure they're using the right version. 
外 | chickentown and mcantelon are participating in this pull regquest 
图 14-7” GitHub 拉动 请 求 的 细 方 

然后 拉动 请 求 会 被 漆 加 到 原始 库 的 问题 列表 上 。 原 始 库 的 所 有 者 可 以 评审 你 的 修改 , 点 击 合 
并 拉动 请 求 ( Merge Pull Request ) 引 入 它们 , 输入 一 条 提交 消息 , 点 击 确认 合并 ( Confirm Merge )。 
然后 这 个 问题 就 被 目 动 关 财 了 。 

在 你 跟 别 人 合作 创建 出 一 个 优秀 的 模块 后 , 接 下 来 就 要 把 它 推 向 全 世界 。 最 好 的 办 法 是 把 它 
添加 到 npm 库 中 。 


14.3 为 npm 库 做 贡献 


假定 你 这 个 URL 短 化 的 模块 已 经 做 了 一 段 时 间 了 ,你 觉得 其 他 Node 用 户 应 该 也 能 用 到 它 。 为 
了 推广 它 , 你 可 以 在 Node 相 关 的 Google 群 组 上 发 帖 , 介绍 它 的 功能 。 但 这 样 你 的 受众 群 只 是 有 限 
的 一 部 分 Node 用 户 ， 并 且 在 人 们 开始 用 上 你 的 模块 后 ， 他 们 没 办 法 了 解 模块 的 更 新 情况 。 
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为 了 解决 可 发 现 和 提供 更 新 的 问题 ， 你 可 以 把 它 发 布 到 npm 上 。 有 了 npm， 你 可 以 轻松 定义 
项 目的 依赖 项 , 在 安装 你 的 模块 时 把 那些 依赖 项 也 给 目 动 安装 上 。 如 果 你 创建 了 一 个 专门 保存 内 
容 ( 比如 博客 文 草 ) 评论 的 模块 ， 可 能 会 引入 一 个 处 理 评论 数据 到 MongoDB 存 储 的 模块 作为 依 
赖 项 。 或 者 一 个 提供 命令 行 工具 的 模块 ， 会 有 一 个 解析 命令 行 参 数 的 辅助 模块 作为 依赖 项 。 

书 看 到 这 里 ,你 已 经 用 npm 装 过 很 多 东西 了 了， 从 测试 框架 到 数据 库 驱 动 无 所 不 包 ， 但 你 还 什 
么 部 没 发 布 过 。 下 一 市 我 们 要 介绍 把 作品 发 布 到 npm 上 所 需 的 步 缀 : 

(1) 准备 包 ; 

(2) 编写 包 规 范 ; 

(3) 测试 包 ; 

(4) 发 布 包 。 

我 们 从 准备 包 开 始 。 


14.3.1 准备 包 


你 想 跟 人 分 享 的 任何 Node 模 块 都 应 该 搭配 上 相关 资源 ， 比 如 文档 、 例子 、 测 试 和 相关 的 命令 
行 工 具 。 模 块 还 应 该 有 一 个 README 文 件 ， 提 供 充 足 的 信息 让 用 户 能 够 快速 入 门 。 

包 目 录 应 该 用 子 目 录 组 织 起 来 。 表 14-2 列 出 了 负 规 的 子 目录 
以 及 它们 都 用 来 做 什么 。 


表 14-2 Node 项 目 中 的 常规 子 目录 
































bin 、docs、 example 、lib 和 





test 


目 录 用 途 

bin 命令 行 脚本 

docs 文档 

example 程序 的 例子 

lib 程序 的 核心 功能 
test 测试 脚本 及 相关 资源 


包 组 织 好 之 后 ， 你 应 该 写 一 个 包 规范 以 便 准备 好 把 它 发 布 到 npm 上 。 


14.3.2 ”编写 包 规 泊 


在 把 包 发 布 到 npm 上 时 ， 和 需要 包含 一 个 机 器 可 读 的 包 规 施文 件 。 这 个 JSON 文 件 的 名 称 是 
package.json， 其 中 有 模块 的 相关 信息 ， 比 如 它 的 名 称 、 描 述 、 版 本 、 依 赖 项 ， 以 及 其 他 特性 。 
Nodejitsu 有 一 个 很 方便 的 网 站 , 给 出 了 一 个 package.json 文 件 样 本 , 当 你 把 鼠标 悬 停 在 样本 文件 的 
任 一 部 分 上 时 还 会 显示 对 该 部 分 内 容 的 解释 ( http://package.json.nodejitsu.com/ )。 

在 package.json 文 件 中 ， 只 有 和 名称 和 版 本 是 必须 的 。 其 他 都 是 可 选 内 容 ， 但 有 一 些 ， 如 采 定 
义 了 , 会 让 你 的 模块 可 用 性 更 强 。 比 如 说 bin， 如 果 定 义 了 的 话 ，npm 就 知道 包 中 的 哪些 文件 是 命 
令 行 工 具 ， 并 让 它们 全 局 可 用 。 
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下 面 是 一 个 规范 伞 本 : 
{ 


"name": "elf" 

"version": "O.0.1" 

"description": "Toy URL shortener' 

"author": "Mike Cantelon <mcantelon@example.com>" 
"ial "ex” 

"angines"™: { "node"™: "™O.4.x" } 


} 

要 查看 package.json 可 用 选项 的 完整 文档 ， 可 以 用 下 面 的 命令 : 

npm help JjJson 

为 手工 生成 ISON 并 不 比 手工 编码 XML 有 趣 多 少 ， 所 以 我 们 来 看 一 些 可 以 让 这 个 过 程 更 轻 
松 的 工具 。ngen 就 是 这 样 的 工具 ， 装 上 这 个 npm 包 后 ， 会 有 一 个 名 为 ngen 的 命令 行 工 具 。 问 几 个 
问题 之 后 ,ngen 会 生成 一 个 package.json 文 什 。 它 还 会 生成 nppm 包 中 通常 会 有 的 一 些 其 他 文件 ， 比 
如 Readme.md 文 件 。 

你 可 以 用 下 面 的 命令 安装 ngen: 

npm install -9 ngen 

装 上 ngen 后 ,你 会 有 一 个 全 局 的 ngen 命 令 ， 如 果 你 在 项 目的 根 日 录 下 运行 这 个 命令 ， 它 会 问 
你 一 些 与 项 目 相 关 的 问题 ,并 生成 一 个 package.json 文 件 ， 以 及 编写 Node 包 通常 会 有 的 其 他 文件 。 
可 能 有 些 生 成 的 文件 你 并 不 需要 ， 可 以 删 控 。 生 成 的 文件 包括 一 个 .gitignore 文 件 ， 指 定 一 些 不 应 
该 添加 到 Git 库 中 的 文件 和 目录 。 还 有 一 个 .npmiegnore 文 件 ， 它 的 作用 跟 .gitignore 文 件 差不多 ,让 
npm 知 道 将 包 发 布 到 npm 上 时 应 该 忽略 哪些 文件 。 

这 里 有 一 个 运行 ngen 命 令 时 的 输出 样 例 : 

Project name: elf 

Enter your name: Mike Cantelon 


Enter your email: mcantelon@gmail .com 
Project description: URL shortening library 




















create : /Users/mike/programming/js/shorten/node modules/ .gitignore 
create : /Users/mike/programming/js/shorten/node modules/ .npmignore 
create : /Users/mike/programming/jJs/shorten/node modules/History.md 
create : /Users/mike/programming/js/shorten/node _ modules/index.js 





生成 package.json 文 件 是 同 npm 发 布 中 最 难 的 部 分 。 这 一 步 一 完成 ,你 就 可 以 准备 发 布 模块 了 。 
14.3.3 测试 和 发 布 包 


发 布 模块 到 npm 上 需要 三 步 ， 本 三 会 逐一 介绍 : 
(1) 在 本 地 测试 包 的 安装 ; 

(2) 如 果 你 还 没有 ， 添 加 一 个 npm 用 户 ; 

(3) 把 包 发 布 到 npm 上 。 
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1. 测试 包 的 安装 

在 模块 的 根 目录 下 使 用 npm 的 link 命 令 可 以 在 本 地 测试 包 。 这 个 命令 让 你 的 包 可 以 在 你 的 机 
器 上 全 局 使 用 ，Node 可 以 像 使 用 由 npm 安 装 的 包 那 样 使 用 它 。 

sudo npm link 

现在 你 的 项 目 被 全 局 链接 了 , 你 可 以 在 1ink 命 令 后 面 放 上 包 名 把 它 装 在 一 个 单独 的 测试 目 
录 中 : 

npm link elf 

包装 好 之 后 ， 在 Node REPL 中 执行 zequire 函 数 引 入 这 个 模块 来 测试 一 下 ，, 像 下 面 的 代码 这 
样 。 你 应 该 能 在 结果 中 看 到 模块 提供 的 变量 或 另 数 : 


node 




















> reaquirel(l'elf'). 





{ version: '0.0.1.', 
initPathData: [Function], 
shorten: [Functionl], 
expand: [Function]| } 
如 果 你 的 包 通 过 了 测试 ， 并 且 你 已 经 结束 了 它 的 开发 工作 ， 在 模块 的 根 目 录 下 执行 apm 的 
unlLink 命 邻 : 


So 

之 后 你 的 模块 就 不 再 是 全 局 可 用 的 了 ,但 稍 后 ， 在 你 完成 模块 到 npm 上 的 发 布 之 后 ， 你 还 可 
以 用 install 命 令 像 平常 那样 安装 它 。 

测试 过 npm 包 之 后 ， 接 下 来 是 创建 npm 发 布 账号 ， 如 果 你 之 前 没有 设置 过 的 话 。 

2. 添加 npm 用 户 

用 下 面 的 命令 创建 你 自己 的 npm 发 布 账号 : 

i 

它 会 提示 你 输入 用 户 名 、 邮 箱 地 址 和 和 密码。 如 果 账 号 添加 成 功 ， 你 不 会 看 到 错误 消息 。 

3. 发 布 到 npm 上 

接 下 来 是 发 布 。 输 入 下 面 的 命令 把 你 的 包 发 布 到 npm 上 : 

i 让 于 和 

你 可 能 会 看 到 警告 , “经 不 安全 的 通道 发 送 授权 ”, 但 如 果 你 没 看 到 其 他 错误 , 说 明 柑 块 已 经 
成 功 发 布 了 。 你 可 以 用 npm 的 view 命 令 验 证 你 的 发 布 是 否 成 功 : 

npm view elf description 

如 果 你 想 引 入 一 或 多 个 私有 库 作 为 nppm 包 的 依赖 项 ， 可 以 。 可 能 你 想 用 一 个 实用 的 辅助 函数 
模块 ， 但 不 把 它 公 开发 布 到 npm 上 。 

要 添加 私有 依赖 项 , 在 通常 放 依赖 模块 名 称 的 地 方 , 你 可 以 放任 何 跟 其 他 依赖 项 的 名 称 不 同 
的 名 称 。 在 通常 放 版 本 号 的 地 方 ， 放 Git 库 的 URL。 下 面 的 例子 是 package.json 文 件 的 一 个 片段 ， 
最 后 一 个 依赖 项 是 私有 库 : 
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"dependencies" : 1 
"omtufmlietr "Se0. .3, 
Tr 3 Sel QL", 





"mingy": i 
"elf": "git://github.com/mcantelon/node-elf.git" 
} 


注意 ， 私 有 模块 也 应 该 包 售 package.json 文 件 。 为 了 确保 这 些 模块 不 会 因为 巩 忽 被 发 布 出 去 ， 
你 可 以 在 package.json 文 件 中 将 private 属 性 设 为 true: 





"private": true, 


现在 你 已 经 掌握 了 设置 、 测 试 和 发 布 模块 到 npm 库 上 的 知识 。 


14.4 ” ”小结 


跟 大 多 数 成 功 的 开源 项 目 一 样 , Node 有 一 个 活路 的 网 上 社区 , 也 就 是 说 你 会 找到 充足 的 在 线 
资源 ， 并 且 能 迅速 地 从 在 线 参 考 资 料 、Google 群 组 、IRC 或 GitHub 问 题 列表 中 得 到 答案 。 

除了 帮 项 目 妃 中 bug，GitHub 还 提供 了 了 Git 服务， 并 且 开 源 用 Web 浏 览 右 查看 Git 库 中 的 代码 。 
借助 GitHub ， 其 他 开发 人 员 如 果 想 贡献 bug 修 订 、 添 加 功能 ， 或 者 把 项 目 引 回 新 的 方向 ， 他 们 很 
容易 分 叉 你 的 开源 代码 。 你 也 可 以 轻松 地 将 提交 到 分 又 上 的 修改 带 回 到 原始 库 中 。 

一 旦 Node 项 目 进 入 了 可 以 跟 其 他 人 分 享 的 阶段 , 你 就 可 以 把 它 提 交 到 Node 包 管理 需 的 库 中 。 
把 你 的 项 目 纳 入 npm 中 ， 其 他 人 更 容易 找到 它 ， 并 且 如 果 你 的 项 目 是 模块 的 话 ， 纳 入 npm 意 味 着 
模块 安装 起 来 更 容易 。 

你 知道 如 何 得 到 帮助 ,在 线 协 作 ， 以 及 分 享 你 的 作品 。Node 之 所 以 能 变 成 现在 这 样 ， 要 归功 
于 活跃 的 ， 大 家 都 积极 参与 的 社区 。 我 们 希望 你 也 变 得 活跃 起 来 ， 成 为 Node 社 区 的 一 份子 ! 
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代码 清单 13-13 ”这 个 简单 的 程序 用 漂亮 的 颜色 输出 本 书 的 标题 和 作者 
Var ansi <= require('ansi'); 
Var Cursor = ansi (process.stdout); 


CUrSOr 
. IESet() 
.WIlitet{! ') 
.bold () 
.underline ( 
.bg .white!l) 
.to.black!) 
.write('Node.js in Action') 
.fao.resetl() 

.bg.resetl() 

.resetUnderline() 
.resetBold!{) 

. Write(! \m') 

.fo.greent) 

.write(' by:\n') 

.fog.cyanl!() 

.WIlitert,’! Mike Cantelon\n’') 
.foq.magental) 


) 


. 三立 二 七 全 1 TJ Holowaychuk\n’') 
.fg.yellow!) 

. WIIliterl! Nathan Rajlich\n') 
.resetl) 


闫 色 人 码 只 是 ansijs 的 关键 特性 之 一 。 我 们 还 没 涉及 光标 定位 代码 ， 如 何 发 出 蜂 鸣 声 ， 或 者 如 
何 隐藏 和 显示 光标 。 你 可 以 参考 ansi.js 的 文档 及 范例 看 看 是 怎么 做 的 。 








13.5 小结 


Node 主 要 是 为 O 相 关 的 任务 设计 的 ， 比 如 创建 HTTP 服务 硕 。 但 正如 你 在 本 章 中 所 学 的 ， 
Node 可 以 用 来 完成 很 多 种 不 同 的 任务 ， 比 如 给 你 的 应 用 服务 硕 创 建 一 个 命令 行 接口 ， 连 接 ASCII 
星 战 服务 带 的 客户 冰 程 序 , 从 股票 市 场 服 务 厅 获 取 统计 数据 进行 显示 的 服务 带 一 一 可 能 性 只 会 党 
限于 你 的 想象 力 。npm 和 node-gyp 就 是 用 Node 编 写 的 复杂 的 命令 行程 序 。 你 可 以 从 中 学 到 很 多 
东西 。 

本 章 讨 论 了 几 个 对 你 开发 程序 有 帮助 的 社区 模块 ,下 一 革 我 们 会 午 点 介绍 如 何在 Node 社 区 中 
找到 这 些 优秀 的 模块 ， 以 及 如 何 将 你 开发 的 模块 页 献 给 社区 ， 从 而 得 到 有 反馈， 做 出 改进 。 社交 
让 人 觉得 心 驰 神 往 啊 ! 
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Node 在 大 多 数 操作 系统 上 安装 起 来 都 不 难 。 你 暨 可 以 用 传统 的 程序 安装 包 安 装 Node， 也 可 
以 用 命令 行 安 装 。 命 令 行 安装 在 OS X 和 Linux 上 很 简单 ， 但 在 Windows 上 最 好 不 要 用 命令 行 。 

为 了 大 你 起 步 ， 接 下 来 的 几 节 内 容 会 详细 介绍 在 OS X、Windows 和 Linux 上 的 安装 过 程 。 本 
附录 的 最 后 一 方 阐述 了 如 何 用 Node 包 管理 大 (npm ) 寻找 和 安装 实用 的 附加 组 件 。 











A.1 在 OS X 上 的 安 疙 


在 OS 义 上 安装 Node 相 当 和 人 简单 直 接 。 官 方 的 安装 包 (http://nodejs.org/#download )， 如 图 A-1 所 
示 ， 提 供 了 一 种 安装 预 编译 版 本 Node 和 npm 的 人 简便 办 法 。 


aNo 





“2 Install Node 





Welcome to the Node Installer 
This package will install node and npm into /usr/local/bin 
@ Introduction 
®@ Destination Select 
@ Installation Type 


和 Installation 


Summary 


NN 








, “ 归 >" 
Go Back | Continue | 
A 





图 A-1 OS X 的 官方 Node 安 装 包 





如 果 你 愿意 用 源码 安装 , 既 可 以 使 用 Homebrew ( http://mxcl.github.com/homebrew/ )， 这 个 工 
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具 会 自动 从 源码 安装 ， 也 可 以 目 己 手动 安装 。 人 然而 在 OS X 上 用 源码 安装 Node， 需 要 系统 上 装 有 
Xcode 开发 者 工具 。 


Xcode 如 果 你 没 装 Xcode， 可 以 从 苹果 的 网 站 上 下 载 Xcode (http://developer.apple. 
com/downloads/ )。 你 必须 注册 成 为 革 果 开发 者 ,这 个 注册 是 免费 的 ,然后 才能 访问 下 载 
页 面 。 完 整 的 Xcode 安装 包 很 大 (将近 4 GB )， 所 以 苹果 还 提供 了 一 个 Xcode 的 命令 行 工 
有 具 作 为 备 选 , 也 在 同一 个 页 面 上 下 载 , 它 提供 了 编译 Node 和 其 他 开源 软件 项 目 所 需 的 最 
小 功能 集 。 

要 快速 检查 你 的 系统 上 是 否 有 Xcode， 可 以 启动 终端 程序 运行 Xcodebuild 命 令 。 如 
果 装 了 ， 你 应 该 能 看 到 一 个 错误 信息 ， 告 诉 你 当前 目录 下 “没有 Xcode 项 目 ”。 

两 种 方法 都 要 求 运 行 终 六 程序 进入 OS X 的 命令 行 接口 ， 终 端 程序 通 篆 放 在 应 用 程序 文件 夹 
下 的 实用 工具 文件 夹 下 。 
如 末 你 在 对 源码 进行 编 详 ， 请 到 A.4 中 查看 必要 的 操作 步骤 。 





用 Homebrew 安 装 


在 OS X 上 用 Homebrew 安 疙 Node 很 简单 ，Homebrew 是 管理 开源 软件 安 疙 的 程序 。 

在 命令 行 中 输入 下 面 的 命令 安装 Homebrew: 

ruby -e "S$(curl -fsSkL raw.github.com/mxcl/homebrew/go)" 

Homebrew 装 好 之 后 ， 可 以 用 下 面 的 命令 安装 Node: 

brew install node 

在 Homebrew 编 详 代 码 时 ， 你 会 看 到 很 多 文本 在 滚动 。 这 些 文本 是 跟 编译 过 程 相关 的 信息 ， 
可 以 忽略 。 











A.2 在 Windows 上 的 安装 





在 Windows 上 安装 Node 最 容易 的 办 法 是 用 官方 的 独立 安 狐 包 ( http://nodejs.org/#download )。 
装 上 之 后 ， 你 就 能 在 Windows 命 令 行 里 运行 Node 和 npm 了 。 

在 Windows 上 也 可 以 通过 编译 源码 安装 Node。 但 那 要 复杂 得 多 ， 并 且 需 要 用 一 个 叫 Cygwin 
的 项 目 ， 它 提供 了 一 个 跟 Unix 兼 容 的 环境 。 你 可 能 不 会 喜欢 通过 Cygwin 使 用 Node， 除 非 有 你 想 
用 的 檬 块 不 能 用 在 Windows 上 ， 或 者 需要 编译 ， 比 如 某 些 数据 库 驱 动 模块 。 

要 安 站 Cygwin， 在 浏 贤 右 中 访问 Cygwin 安 站 包 的 下 载 链 接 ( http://cygwin.com/install.html ) 
下 载 setup.exe。 双 击 setup.exe 开 始 安 猴 ， 然 后 一 直 保 留 默 认 选 项 点 击 下 一 步 ， 直 到 选择 下 载 站 点 
那 一 步 。 从 下 载 站 点 列表 中 随便 选 一 个 ， 点 击 下 一 步 。 如 采 你 看 到 关于 Cygwin 是 主 版 本 的 警告 ， 
点 击 OK 继续 。 

现在 你 应 该 能 见 到 Cygwin 的 包 选 择 器 ， 如 图 A-2 所 示 。 
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EE cygwin Setup - Select Packages [于 才 辐 -EE 
Select Packages 本 
Select packages to install ECE 





Search 






Category Curert 
日 划 榜 Defaukt 






Audio 六 Default 
Base #¥ Default 


日 Devel 籽 Default 


Cear Keep Prev cur OEp Category 


Package 





Accessibilty Default 
Admin 心 Default 
Archive Default 


Database Y Default 





*¥ Skip ma nia 15ik ELFIO: ELFfile rsader and producerimplemented as a C= library 

#*¥ Skip na nia 2,132k SWI-Prolog: Prolog Interpreter 

*¥ Skip na ma 84k XmHTML-devel:A widget capable of displaying HTML 3.2 corfol 

*¥ Skip na nia 104k aalib-devel: An ascii art library - (development) 

*¥ Skip nia ma 170k asciidoc: Tex based document generation 

*¥ Skip na nia 141k astyle: Mtistic Style is a reindenter and reformatter of C, C++, Ci: 

*¥ Skip nia nia 115k autobuild: Generate summary information from build logs 

*¥ Skip nia nia 此 autocorf: Wrapper scripts for autocorf commands 

*¥ Skip na nia 200k autoconf2.1: Stable version of the automatic configure script built 
dip nia nia 955k autoconf2.5: Development version of the automatic configure scr _ 


Ml b 


区 | Hide obsolete packages 


图 A-2 ”Cygwin 的 包 选 择 融 允许 你 选择 安装 在 系统 上 的 开源 软件 
用 这 个 选择 大 挑选 


先 你 要 安装 在 类 Unix 环 境 中 的 软件 功能 ( 表 A-1 给 出 了 与 Node 开 发 相关 的 安 


表 A-1 运行 Node 所 需 的 Cygwin 包 


Category Package 
devel gcc4-g+ 十 
devel git 

devel make 

devel openssl-devel 
devel pkg-config 
devel zlib-devel 

net inetutils 
python python 

web weget 


选 好 包 之 后 点 击 下 一 步 。 


然后 你 就 会 看 到 你 所 选择 的 包 的 依赖 项 列表 。 那些 也 是 要 装 的 , 所 以 还 是 点 击 下 一 步 接受 它 
们 。 现 在 Cygwin 会 下 载 你 需要 的 包 ， 一 旦 下 载 完成 ， 点 击 完 成 。 

点 击 果 面 上 的 图 标 , 或 者 在 开始 菜单 中 启动 Cygwin。 然后 你 就 可 以 编译 Node 了 (A.4 节 给 出 
了 必须 的 步骤 )。 
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A.3 在 Linux 上 的 安装 


在 Linux 上 安 闻 Node 通 稼 一 点 也 不 会 觉得 痛 癌 。 我们 会 介绍 两 个 流行 的 Linux 发 行 版 上 的 安 儿 
过 程 : Ubuntu 和 CentOS。 在 有 些 发 行 版 上 ，Node 也 可 以 通过 包 管 理 吉 获得 ，GitHub 上 也 有 其 他 
的 安装 指导 : https://github.com/joyent/node/wiki/Installing-Node.js-via-package-manager。 


A.3.1 在 Ubuntu 上 安装 的 前 提 
把 Node 安 装 到 Ubuntu 上 之 前 ， 需 要 先 安装 一 些 包 。 在 Ubuntu 11.04 及 之 后 的 版 本 中 用 一 行 命 
令 就 可 以 完成 : 
sudo apt-get install build-essential libssl-dev 
sudo sudo 命 令 用 来 以 “超级 用 户 ”( 也 被 称 为 “root”) 的 身份 执行 另 一 条 命令 。 


在 安装 软件 时 经 常会 用 到 sudo， 因 为 要 把 文件 放 到 受 保护 的 区 域 去 ， 而 超级 用 户 可 以 
访问 系统 上 的 任何 文件 ， 不 受 文件 许可 的 限制 。 


A.3.2 在 CentOS 上 安装 的 前 提 


把 Node 安 装 到 CentOS 上 之 前 ， 需 要 先 安装 一 些 包 。 在 CentOS 5 上 要 执行 下 面 的 命令 : 


sudo yum groupinstall 'Development Tools' 
sudo yum install openssl-devel 


作为 前 提 条 件 的 包 都 已 经 安装 好 了 ， 你 可 以 去 编译 Node 丁 。 
A.4 编译 Node 


在 所 有 操作 系统 上 编译 Node 步 又 都 是 一 样 的 。 

先 在 命令 行 中 输入 下 面 的 命令 创建 一 个 临时 文件 来， 用 来 放下 载 的 Node 源 人 码 : 

mkdir tmp 

接 下 来 进入 上 一 步 中 创建 的 目录 : 

cd tmp 

现在 输入 下 面 这 条 命令 : 

curl -0O http://nodejs.org/dist/node-latest.tar.gz 

接 下 来 你 会 看 到 提示 下 载 进度 的 文本 。 进 度 达 到 100% 时 就 会 回 到 命令 提示 符 。 输 入 下 面 的 
命令 解压 你 收 到 的 文件 : 

tar zxvf node-latest.tar.gz 


然后 你 应 该 能 看 到 很 多 输出 在 深 动 ,最 后 义 回 到 了 命令 提示 符 。 在 提示 符 中 输入 下 面 的 命令 ， 
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列 出 当前 文件 夹 下 的 文件 ， 基 中 应 该 有 你 刚 解压 的 目录 名 : 

ls 

接着 输入 下 面 的 命令 进入 这 个 目录 : 

CQ node-v* 

你 现在 应 该 在 包含 Node 源 人 码 的 目录 里 了 。 输 入 下 面 的 命令 运行 配置 脚本 , 以 便 针 对 你 的 系统 
准备 相应 的 安装 : 

./Cconfigure 

接 下 来 输入 下 面 的 命令 编译 Node: 

make 








Node 的 编译 通常 要 花 点 儿 时 间 , 所 以 请 耐心 地 看 着 一 大 堆 文 字 在 屏幕 上 深 动 。 那些 文字 都 是 
跟 编 译 过 程 相关 的 信息 ， 可 以 忽略 。 


调皮 的 CYGWIN 如 果 你 在 Windows 7 或 Vista 上 运行 Cygwin， 这 一 步 可 外 


E 会 遇 到 错 
误 。 | 问题 ， We 系 。 要 解决 它们 ， 退 出 Cygwin 环 境 ， 运 行 ash.exe 
命令 行程 序 ( 在 Cygwin 目 录 下 ， 


通常 是 ci\cygwin\bin\ash.exe )。 在 ash 命 令 行 中 ， 输 入 
/bin/rebaseall -v。 完 了 之 后 重 居 你 的 电脑 。 这 样 应 该 可 以 解决 你 的 Cygwin 问 题 。 


到 这 儿 几 乎 就 算 搞 定 了 。 等 文本 停止 滚动 ， 你 再 次 见 到 命令 行 提 示 符 时 ， 可 以 输入 安装 过 程 





的 最 后 一 个 命令 : 





sudo make install 


结束 之 后 ， 输 入 下 面 的 命 


node -vyv 


现在 你 的 机 需 上 应 该 已 经 有 Node 了 ! 








令 运 行 Node， 让 它 显 示 版 本 号 ， 验 证 安装 是 否 成 功 : 


A.5 使 用 Node 包 管理 


[| 


于 


Node 装 上 了 , 你 应 该 可 以 使 用 内 置 模块 来 执行 网 络 任务 、 跟 文件 系统 交互 , 以 及 程序 中 所 和 需 
的 其 他 常见 任务 了 。Node 内 置 的 模块 被 统称 为 Node 核 心 。 尽 管 Node 的 核心 涵盖 了 很 多 实用 的 功 


能 ， 但 你 很 可 能 还 是 要 用 社区 创建 的 功能 。 图 A-3 展 示 了 Node 核 心 及 附加 模块 彼此 之 间 在 概念 上 
的 关系 O 〇 
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社区 创建 的 模块 


依赖 于 


依赖 于 


依赖 于 


Node 核 心 


图 A-3 Node 技术 栈 是 由 全 局 可 用 的 功能 ， 核 心 模块 和 社区 创建 的 模块 组 成 的 











你 可 能 了 解 也 可 能 不 了 解 附 加 功能 社区 库 的 概念 , 这 取决 于 你 曾经 用 过 的 语言 。 这些 库 类 似 
于 实用 程序 构建 块 的 库 , 它们 可 以 帮 你 做 一 些 语言 本 身 不 太 容 易 实现 的 功能 。 这 些 库 一 般 是 模块 
化 的 ， 通常 不 是 一 次 性 地 获取 整个 库 ， 而 是 只 获取 你 需要 的 附加 组 件 。 

Node 社 区 自己 有 管理 社区 附加 组 件 的 工具 : Node 包 管理 套 ( Node Package Manager，npm )。 
在 这 一 广 里 ,你 将 会 学 到 如 何 用 npm 找 到 社区 附加 组 件 ， 查 看 附加 组 件 的 文档 ， 以 及 探索 附加 组 
件 的 源码 。 




















我 的 系统 上 没有 npm 
如 果 你 装 了 Node， 那 么 npm 很 可 能 也 已 经 装 上 了 。 你 可 以 在 命令 行 中 运行 npm 来 试 一 下 ， 
看 看 命令 能 否 找 到 。 如 果 没 有 ， 你 可 以 像 下 面 这 样 安装 npm: 


cd /tmp 
git clone git://github.com/isaacs/npm.git 


cd npm 
sudo make install 


装 上 npm 后 ， 在 命令 行 中 输入 下 面 的 命令 来 确认 npm 是 否 能 用 ( 让 它 输出 版 本 号 ): 
mon 


如 果 npm 安 装 正确 ， 应 该 能 看 到 它 输 出 下 面 这 种 数字 : 
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如 果 你 在 安装 npm 时 出 了 问题 , 最 好 的 办 法 是 去 npm 在 GitHub 上 的 网 站 (http://github.com/ 
isaacs/npm )， 可 用 找到 最 新 的 安装 指导 。 


A.5.1 寻找 包 


用 命令 行 工 具 npm 访 问 社 区 附加 组 件 很 方便 。 这 些 附 加 模块 通常 被 称 为 包 ， 并 且 存 放 在 网 上 
的 存储 库 中 。 对 于 PHP、Ruby 和 Perl 的 用 户 而 言 ，npm 就 像 PEAR、Gem 和 CPAN。 

npm 特 别 方便 。 有 了 npm， 只 用 一 行 代码 就 可 以 下 载 和 安 猴 包 。 寻 找 包 也 很 容 多 ， 还 可 以 查 
看 包 的 文档 ， 探 索 包 的 源码 ， 并 发 布 目 己 的 包 以 便 跟 Node 社 区 分 对 它们 。 

你 可 以 用 npm 的 search 命 令 查找 库 中 的 包 。 比 如 说 ， 如 果 你 想 找 一 个 XML 生成 需 ， 只 需要 输 
入 下 面 这 条 命令 : 

npm search xml generator 

npm 第 一 次 做 搜索 时 ， 会 停顿 很 长 时 间 来 下 载 库 信息 。 而 以 后 再 搜索 时 就 很 快 了 。 

除了 用 命令 行 搜索 ，npm 项 目 还 提供 了 库 的 Web 搜 索 界 面 : http://search.npmjs.org/。 如 图 A-4 
所 示 ， 这 个 网 站 还 提供 了 一 些 统计 数据 ， 有 多 少 包 ， 哪 个 包 被 其 他 包 依 赖 的 最 多 ,以 及 最 近 有 哪 
些 包 更 新 本 。 





























npm -~ Mozilla Firefox 
妈 | 口 npm 1 十 


《 https://npmjs.org 


npm ee EE 


Node Packaged Modules 


Total Packages: 18 546 


ao NPM REGISTRY 


131 809 downloads in the last day 
3672 443 downloads in the last weel 
13363477 downloads in the last month 
Patches welcome! 
Any package can be installed by using npm install. 
Add your programs to this index by using npm publish. 


Recently Updated Most Depended Upon 


es。 1m stylus-lemonade 。 1789 underscore 
。 3m bytestmoudlewithmzj 。 1080 request 
。 lO0Om taichi-access 。 1065 async 





图 A-4 npm 搜 索 网 站 提供 了 模块 受 欢迎 程度 的 统计 数据 
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npm 的 Web 搜 索 界 面 还 可 以 浏览 单个 包 ， 显 示 包 的 依赖 项 和 项 目的 版 本 控制 库 的 在 线 地 址 等 


A.5.2 ”安装 


在 找到 你 想 安 装 的 包 后 ，npm 主 要 有 两 种 安装 方式 : 局 部 安装 和 全 局 安装 。 

局 部 安装 把 下 载 的 模块 放 到 当前 工作 目录 的 node modules 文 件 夹 下 。 如 果 这 个 文件 夹 不 存 
在 ，npm 会 创建 它 。 

这 里 有 个 局 部 安装 express 包 的 例子 : 

npm install express 

在 非 Windows 系 统 上 ， 全 局 安装 把 下 载 的 模块 放 到 /usr/local 目 录 下 ，Unix 类 系统 一 般 会 把 用 
户 安 装 的 程序 放 在 这 里 。 在 Windows 上 ， 全 局 安装 的 npm 模 块 会 放 在 你 用 户 目 录 下 的 
Appdata\Roaminenpm 子 日 录 中 。 

这 里 有 个 全 局 安装 express 包 的 例子 : 

rs 

如 果 你 在 做 全 局 安装 时 没有 足够 的 文件 许可 权限 ， 可 以 在 命令 前 加 上 sudo。 比 如 : 

sudo npm install -g express 


包 雄 好 之 后 ， 接 下 来 就 该 找 出 它 的 工作 方式 了 。 竺 运 的 是 npm 让 这 个 过 程 变 得 很 容易 。 














A.5.3 探索 文档 和 包 代 码 


用 npm 查 看 包 作 者 的 在 线 文 档 也 很 方便 ， 当 然 前 提 是 有 文档 。npm 的 docs 命 令 会 打开 一 个 种 
着 指定 包 文 档 的 Web 浏 览 上 大。 这 里 有 个 查看 express 包 的 文档 的 例子 : 

npm docs express 

即便 包 没 有 安 猴 ， 你 也 可 以 查看 包 文 档 。 

如 采 包 的 文档 不 完整 或 讲 的 不 清楚 ,通常 如 果 能 检查 包 的 源码 会 很 方便 。npm 提 供 了 一 种 很 
人 简便 的 办 法 ， 它 会 党 衍 一 个 子 shell, 将 工作 目录 设 定 为 包 源 人 码 的 项 层 目 录 。 这 里 有 一 个 探 寺 局 部 
安装 的 express 源 人 码 文 件 的 例子 : 

npm explore express 

要 探 索 全 局 安 妆 包 的 源码 ， 只 要 在 npm 命 令 后 面 加 上 -g 选 项 就 可 以 了 。 比 如 : 

npm -9 explore express 

探索 包 也 是 极 佳 的 学 习 方 法 。 阅 读 Node 源 人 码 通 常 能 学 到 你 不 台 悉 的 编程 技术 和 代码 的 组 织 
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调试 Node 


在 开发 过 程 中 ,特别 是 在 学 习 新 语言 或 框架 时 , 调试 工具 和 技术 很 和 带 助 。 本 市 会 介绍 一 些 
方法 ， 让 你 可 以 准确 地 判断 出 你 的 Node 程 序 代 人 码 究 竟 在 做 些 什么 。 


B.1 用 JSHint 分 析 代 码 


跟 语 法 和 作用 域 相 关 的 错误 是 各 见 的 开发 陷阱 。 在 试图 确定 程序 问题 的 根源 时 , 第 一 道 防线 
是 查看 代码 。 然 而 ， 当 你 看 了 源码 ， 却 不 能 马上 发 现 其 中 的 问题 时 ,， 那 你 就 应 该 运行 一 个 工具 来 
仿 查 代码 中 的 问题 了 。 

JSHint 就 是 这 样 的 实用 工具 。 它 可 以 揪 出 代码 中 特别 严重 的 问题 , 比如 调用 的 函数 没有 定义 。 
它 还 可 以 找 出 编码 风格 方面 的 问题 ， 比 如 没有 按照 JavaScript 的 编码 规范 把 类 构造 器 的 首 字 母 大 
写 。 即 便 你 从 不 运行 JSHint， 通 读 它 查找 的 错误 也 能 让 你 对 可 能 的 编码 陷阱 提高 警惕 。 

JSHint 是 基于 JSLint 的 项 目 ，JSLint 是 一 个 存在 了 十 多 年 的 JavaScript 源 人 码 分 析 工 具 。 然 而 
JSLint 的 可 配置 性 不 太 强 ， 因 此 促 生 了 JSHint。 

按照 很 多 人 的 看 法 ，JSLint 在 强制 推荐 的 编码 风格 方面 过 于 严格 了 。 JSHint 与 之 相反 ， 你 可 
以 告诉 它 你 想 检查 什么 , 想 忽略 什么 。 比 如 分 号 ， 从 技术 角度 讲 JavaScript 解 释 天 是 有 要 求 的 , 但 
磅 到 没有 分 号 的 情况 时 ， 大 多 数 解 释 紫 都 会 用 自动 化 分 号 插入 ( Automated Semicolon Insertion ， 
ASI) 插入 它们 。 因 此 有 些 开发 人 员 会 在 他 们 的 源码 中 省 掉 分 号 ， 以 减少 视觉 干扰 ， 并 且 代 码 跑 
起 来 也 没 问题 。 而 JSLint 就 会 抱 忽 ， 说 缺少 分 号 是 个 错误 ,通过 配置 ，JSHint 可 以 忽略 这 种 “ 错 
误 ”， 只 检查 特别 严重 的 问题 。 

安装 JSHint 后 ， 会 有 一 个 检查 源码 的 命令 行 工具 jshint。 你 应 该 执行 下 面 这 条 命令 用 npm 全 局 
安装 JSHint: 
































npm install -9 jshint 

JSHint 装 好 后 ， 你 只 需 输 入 下 面 这 个 命令 就 可 以 检查 JavaScript 文 件 了 : 

jshint my _ app.]s 

你 可 以 给 JSHint 创 建 一 个 配置 文件 ， 以 表明 你 要 检查 什么 。 一 种 办 法 是 从 GitHub 上 复制 默认 
的 配置 文件 (https://github.com/jshint/node-jshint/blob/master/.jshintrc ) 到 你 的 机 大 上 ,然后 以 此 为 
基础 进行 修改 。 
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如 果 你 将 配置 文件 命名 为 jshintrc， 并 把 它 放 在 你 的 程序 目录 下 ， 或 者 在 程序 目录 的 任 一 
目录 下 ，JSHint 能 自动 找到 并 使 用 它 。 

此 外 ， 你 也 可 以 用 配置 选项 指定 JSHint 配 置 文件 的 位 置 。 下 面 这 个 例子 告诉 JSHint 使 用 一 个 
非 标准 文件 名 的 配置 文件 : 

jshint my app.js --config /home/mike/jshint.json 


要 了 解 每 个 具体 配置 项 的 详细 信息 ,请 参考 JSHint 的 网 站 : http:/www.jshint.com/docs/#options。 


B.2 输出 调试 信息 心 \ 


如 打 你 的 代码 表面 上 是 合理 的 ,但 程序 的 表现 依然 很 怪异 ,你 可 以 染 加 一 些 调试 输出 ， 以 便 
对 诬 层 所 做 的 事情 有 更 清楚 的 认识 。 

















B.2.1 用 console 模 块 调试 


console 是 内 置 的 Node 模 块 ， 为 控制 台 的 输出 和 调试 提供 了 实用 的 功能 。 

1. 输出 程序 的 状态 信息 

console.1og 国 数 可 以 用 来 加 标准 输出 中 输出 程序 的 状态 信息 。console.info 是 同一 呆 数 
的 另 一 个 名 称 。 可 以 给 出 printf () 风 格 的 参数 (http:/en.wikipedia.org/wiki/Printf )。 

console.log('Counter: %d', counter); 

而 输出 警告 和 错误 信 , 息 的 console .warn 和 console.error 崩 数 也 差不多 。 唯 一 的 区 别 是 
它们 不 是 显示 到 标准 输出 中 ,而 是 显示 到 标准 错误 中 。 你 也 可 以 把 警告 和 错误 信息 转 到 日 志文 件 
中 ， 如 下 例 所 示 。 

node server.js 2> error.log 


console.dqir 国 数 会 输出 对 象 的 内 容 。 下 面 这 个 例子 给 出 了 它 的 输出 是 什么 样 的 : 


{ name: ' Paul Robeson', 
interests: [ 'football', 'politics', 'music', 'acting' ] } 


2. 输出 计时 信息 
te 两 个 国 数 ， 如 果 一 起 用 的 话 , 可 以 计算 代码 中 部 分 片段 的 执行 时 长 。 计 时 可 
个 同步 进行 。 要 开始 计时 ， 把 下 面 的 代码 添加 到 你 要 计时 的 起 始点 上 。 

console .time('myCcomponent ' ) ; 

结束 计时 ， 返 回 自 开始 计时 后 过 去 的 时 间 ， 把 下 面 这 行 代码 添加 到 应 该 停止 计时 的 地 方 。 
console.timeEnd('myComponent ' ) ; 

这 行 代码 会 显示 所 用 的 时 间 。 

3. 输出 堆栈 跟踪 

堆栈 跟踪 提供 了 程序 逻辑 中 某 点 之 前 执行 了 哪些 函数 的 信息 。 比方 说 , 当 Node 在 程序 执行 过 
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程 中 直到 错误 时 ， 它 会 输出 堆栈 跟踪 ,提供 程序 逻辑 中 导致 错误 的 相关 信息 。 
你 可 以 在 程序 中 的 任何 位 置 执 行 console.trace() 输 出 堆栈 跟踪 ， 并 且 不 会 导致 程序 停止 
执行 。 
输出 的 堆栈 跟踪 如 下 例 所 示 。 
Trace : 
at lastFunction (/Users/mike/tmp/app.jJs:12:11) 
at secondFunction (/Users/mike/tmp/app.Js:8:3) 


at firstFunction (/Users/mike/tmp/app.Js:4:3) 
at Object.<anonymous> (/Users/mike/tmp/app.Js:15:3) 








注音， 堆栈 跟 踊 中 的 执行 顺序 是 按时 间 倒 序 显示 的 。 


B.2.2 ”用 debug 模 块 管理 调试 输出 


输出 的 调试 信息 很 有 价值 , 但 如 果 不 是 正在 解决 问题 ,那些 信息 最 终 就 显得 太 乱 了 。 调试 信 
县 的 输出 最 好 可 以 开关 。 

用 环境 变量 可 以 切换 调试 信息 的 输出 。T.J.Holowaychuk 的 debug 模 块 为 此 提供 了 一 个 便利 的 
工具 ， 人 允许 你 用 环境 变量 pEBUG 管 理 调试 信息 的 输出 。 第 13 章 详细 介绍 了 debug 柑 块 的 用 法 。 




















B.3 Node 内 置 的 调试 器 


对 于 添加 简单 的 调试 输出 无 法 满足 需要 的 情况 ，Node 还 自 带 了 一 个 命令 行 的 调试 器 。 用 
debug 关 键 字 启动 程序 可 以 启用 这 个 调试 磊 ， 比 如 : 

node debug gerver,]s 

当 以 这 种 方式 运行 Node 程 序 时 ， 你 会 看 到 程序 的 头 几 行 ， 以 及 一 个 调试 器 提示 符 ， 如 图 B-1 
所 示 。 





ANMA 2. Shell 至 


$ node debug server .js 

< debugger listening on port 5858 
connecting... ok 

break in server.]s:1 


1 http = require('http"); 
ra 
3 http.createServer(function (req, res) 1 


debug> 四 





图 B-1 启动 Node 内 置 的 调试 器 


“break in server.js:1” 这 一 行 表明 调试 套 在 执行 第 一 行 代码 前 停 住 了 。 
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B.3.1 调试 器 导 


你 可 以 在 调试 需 提 示 符 中 控制 程序 的 执行 。 可 以 输入 next (或 只 输入 n ) 执行 下 一 行 代码 。 
此 外 ， 还 可 以 输入 cont (或 只 输入 c ) 让 它 一 直 执 行 ， 和 耳 到 被 中 断 。 

终止 程序 ,或 任何 被 称 为 断 点 的 东西 都 可 以 中 汤 调 试 妖 。 汤 点 是 你 想 让 调试 各 停 止 执行 的 点 ， 
以 便 检查 程序 的 状态 。 

一 种 添加 断 点 的 办 法 是 在 程序 中 要 放置 断 点 的 地 方 添加 一 行 代码 。 这 行 代码 中 应 该 包含 
debugger; 语 句 ， 如 代码 清单 B-1 所 示 。 正 和 常 运行 Node 程 序 时 ，dqepugger; 什 么 也 不 做 ， 所 以 你 
可 以 把 它 留 在 那里 ， 也 不 用 担心 有 什么 不 良 影响 。 








代码 清单 B-1 ”编程 添加 断 点 
var http = YeculLrel REtD  ) | 


function handleRegquest (req, res) { 
res.writeHead{({200, {'Content-Type': 'text/plain' }},， 
res.end('Hello World\n:':); 

} 


http.createServer (function (reg, res) { i 
往 代 码 中 添加 断 点 
debugger; 


handleRequest (req, res); 
}) .listen(1337, '127.0.0.1'); 


console.log('Server running at http://127.0.0.1:1337/'); 


如 采 你 在 debug 模 式 中 运行 B.1 中 的 代码 , 它 会 先 中 断 在 第 一 行 。 在 你 的 调试 硕 中 输入 cont， 
它 会 继续 执行 创建 HTTP 服 务 絮 ， 等 待 连接 。 如 果 你 用 浏览 絮 访 问 http://127.0.0.1:1337 创 建 连接 ， 
会 见 到 它 在 aebuggez ; 那 一 行 中 朵 。 

输入 next 继 续 执 行 下 一 行 代码 。 当 前 行 会 变 成 对 男 数 handqleReauest 的 调用 。 如 果 你 再 次 输 
和 next 继续 执行 下 一行 ， 调试 需 不 会 进入 handqleRedquest 中 跟踪 其 中 的 每 - 行 代码 。 但 如 果 你 
输入 step， 调试 需 则 会 进入 handqleReauest 困 数 中 ， 以 便 你 可 以 跟 踊 这 个 函数 中 的 任何 问题 。 
如 果 你 改 主意 了 了, 不想 再 调试 handleRequest， 可 以 输入 out (或 o ) 跳出 这 个 函数 。 

除了 在 源码 中 指定 ,在 调试 名 中 也 可 以 设 定 断 点 。 要 把 断 点 设 定 在 调试 带 中 的 当前 行 , 在 调 
试 人 中 输入 setBreakpoint () (或 sb() )。 在 特定 行 设 定 断 点 也 是 可 以 的 (sb ( 行 起 ) ), 或 者 把 
断 点 设 定 在 执行 特定 函数 时 ( sb('fn()') )。 

在 你 想 取 消 断 点 时 ， 可 以 用 clearBreakpoint() 国 数 (cb() )。 这 个 函数 的 参数 跟 
setBreakpoint () 一 样 ， 只 是 它 做 的 事情 是 相反 的 。 


B.3.2 ”调试 器 中 状态 的 检查 及 处 理 


如 采 你 要 关注 程序 中 一 些 特定 的 值 ， 可 以 添加 观测 着。 当 你 浏览 代码 时 ,观测 融会 把 变量 的 
值 告诉 你 。 
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比如 说 ， 在 调试 清单 B-1 中 的 代码 时 ， 你 可 以 输入 watch ("reg.headers['user-agent']")， 
并 在 每 一 步 中 查看 浏览 大 发 出 的 请 求 类 型 是 什么 。 要 查看 观测 需 的 列表 , 可 以 输入 watchers 命 令 。 
要 移 除 观测 需 ， 用 unwatch 命 令 。 比如 unwatch ( "req .headers['user- agent ' ]") 。 

在 调试 过 程 中 的 任 一 点 ， 如 果 你 想 要 全 面 地 检查 或 处 理 程序 状态 ， 可 以 用 rep1 命 令 进 入 读 
取 - 计 算 -输出 -循环 (REPL )。 你 可 以 输入 任意 的 JavaScript 表 达 式 计算 它 。 要 退出 REPL 返 回 到 调 
试 带 中 ， 请 按 Ctrl-C。 

调试 好 了 后 ， 你 可 以 按 两 次 Ctrl-C 退 出 调试 种， 也 可 以 按 Ctrl-D， 或 输入 . exit 命令 。 

这 些 就 是 调试 可 的 基本 用 法 。 要 了 解 调试 锅 还 能 做 什么 的 话 情 ， 请 访问 Node 的 官方 页 面 : 
http://nodejs.org/apl/debugger.html。 

















B.4 Node 检 查 器 


Node 检 查 器 是 除 Node 内 置 的 调试 器 之 外 的 另 一 种 选择 。 它 用 基于 Webkit 的 浏 览 器 ， 比 如 
Chrome 或 Safari， 而 不 是 命令 行 作 为 界面 。 


B.4.1 Node 检查 器 入 门 





在 你 开始 调试 之 前 ,应 该 用 下 面 的 npm 命 令 全 局 安装 Node 检 查 器 。 闭 好 之 后 ， 就 可 以 在 你 的 
系统 上 使 用 node-inspector 命 令 了 : 

npm install -g node-inspector 

要 调试 Node 程 序 ， 用 命令 行 选项 --depbug-brk 启 动 它 : 

node --debug-brk server.js 

用 --dqebug-brk 选 项 会 让 调试 在 程序 的 第 一 行 代码 前 插入 一 个 断 点 。 如 末 你 不 想 这 样 ， 可 
以 用 -- Qqebud。 

程序 运行 起 来 后 ， 局 动 Node 检 查 术 : 

node-inspector 

Node 检 查 器 的 有 趣 之 处 在 于 它 使 用 了 跟 WebKit 的 Web 检 查 器 一 样 的 代码 ， 但 是 插入 到 了 
Node 的 JavaScript| 擎 中 ， 所 以 Web 开 发 人 员 用 起 它 来 应 该 会 党 得 手 到 擒 来 。 

Node 检 查 希 运行 起 来 后 ， 在 你 的 WebKit 浏 览 硕 中 转 到 http://127.0.0.1:8080/debug?port=5858 
中 ， 你 应 该 可 以 看 到 Node 检 查 硕 了 。 如 采 你 市 着 --dqebug-brk 选 项 运行 Node 检 查 和 项 ， 它 会 马上 
显示 你 程序 的 第 一 个 脚本 ， 如 图 B-2 所 示 。 如 果 你 用 --dqebug 选 项 ， 则 必须 用 脚本 选择 器 ， 图 B-2 
中 名 为 “step.js” 的 脚本 ， 选 择 你 要 调试 的 脚本 。 
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= Ss ) ©) node inspector 


@ | 127.0.0.1:8080/debug?port=5858 















step.js:0 人 IF + + py Paused 
办 Cfunction Cexports, reauire, module, —_filename, dirnome) ; bp Watch Expressions 
vCall Stack 


七 

3 functiton handleRequest(req, res) 1 

4 res.writeHeaod(280, {Content-Type’: ‘text/ploin’}); 
5 res.end( "Hello World\n" ); 





Module. compile module.js:441 


module.js:#59 
3 http.createServerCfunction (req, res) 1 Module._extensions..js 

| debugger; Module.load module.js:348 
1@ hondleRegquest(regq, res); 





11 |}).listen(1337, '127.08.0.1'); Module. load module.is:308 

12 Module.runMain module.js:#79 

3 | V "unning at http://127.0.80.1: Ps i 
console.1log(C' Server running at http://1i27.0.0.1:1337/" ); node.js:192 
startup.processNextTick.process. tic 

15 |}); kCallback 3 
= 41*| VScope Variables " 
2= A 


图 B-2? Node 检查 器 


左 侧 有 红色 和 藤 头 指 看 的 那 一 行 是 接 下 来 要 执行 的 代码 。 








B.4.2 ”Node 检查 器 导航 


要 进入 程序 中 的 下 一 个 函数 调用 , 点 击 那 个 看 起 来 像 小 加 点 上 面市 个 弧 形 入 头 的 按钮 。 Node 
念 查 需 跟 命令 行 的 Node 调 试 锅 一 样 , 也 允许 你 跟 到 函数 中 。 当 红 箭 头 出 现在 函数 调用 左边 时 , 你 
可 以 点 击 那个 有 箭头 癌 下 指 回 小 圆 点 的 按钮 跟 到 盯 数 里 面 。 要 跳出 这 个 函数 ,点 击 小 圆 点 上 有 移 
上 第 头 的 按钮 。 如果 你 在 用 Node 核 心 或 社区 模块 , 在 你 跟踪 调试 程序 时 , 调试 天 会 切换 到 这 些 模 
块 的 脚本 文件 中 。 不 要 大 慰 小 怪 ， 它 在 攻 一 点 还 会 回 到 你 的 程序 代码 中 。 

要 在 运行 Node 检 查 带 时 添加 晰 点 ,点 击 脚 本 左 侧 任 一 行 的 行 号 。 如 来 你 想 消除 所 有 靳 上 后， 点 
击 跳 出 按钮 (第 头 向 上 ) 右 侧 那个 按钮 。 

Node 检 查 癌 还 有 一 个 有 趣 的 功能 ， 允 许 你 在 程序 运行 时 修改 代码 。 如 末 你 想 修改 某 行 代码 ， 
只 要 双击 它 ， 编 辑 ， 然 后 在 这 一 行 之 外 扣 击 就 行 了 。 














B.4.3 ”在 Node 检 查 器 中 浏览 状态 

在 调试 程序 时 , 在 对 调试 带 进 行 导航 的 按钮 下 面 有 可 折 针 面板 , 你 可 以 用 它们 检查 状态 ， 如 
图 B-3 所 示 。 你 可 以 检查 调用 堆栈 和 当前 执行 代码 作用 域内 的 变量 。 在 变量 上 双击 可 以 操作 并 修 
改 它们 的 值 。 你 还 可 以 像 Node 内 置 的 命令 行 调试 名 一 样 ,， 添加 观测 表达 式 , 在 你 按 步 执行 程序 时 
显示 。 
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| Fs Paused 
所 Watch Expressions 
| Breg.heaoders['user-aogent']: Mozilla/5.8 (Macintosh: Intel Mo_ 





Add ， Refresh | 





| b Call Stack 
| Scope Variables 


了 Local 
vrea: Object 

Ww client: Object 
complete: folse 

= connection: Object 

bb heaoders: Object 
httpVersion: i.1 
httpVersionMajor: 1 
httpVersionMinor: 1 
method: GET 
reodoble: true 

= socket: Object 下 


图 B-3 ”用 Node 检 查 需 浏览 程序 的 状态 








要 想 知 道 如 何 充分 利用 Node 检 查 带 ， 请 访问 它 的 GitHub 项 目 主页 : https://github.com/ 
dannycoates/node-lnspector 。 


有 疑问 就 刷新 ”如果 你 在 使 用 Node 检 查 器 时 碰 到 了 古怪 的 行为 ， 刷 新 浏览 器 可 能 
会 有 帮助 。 如 果 那 样 也 不 起 作用 ， 可 以 试 着 重启 你 的 Node 程 序 和 Node 检 查 器 。 


图 灵 社 区 会 员 quqingtao 专 享 尊重 版 权 


Er 


Express 的 扩展 及 氏 直 














Express 提 供 了 很 多 开 箱 即 用 的 特性 ， 但 扩展 Express 并 微调 它 的 配置 可 以 简化 开发 ， 让 它 做 
的 更 多 。 


C.1 扩展 Express 





口 创建 自己 的 模板 引擎 ; 
口 享用 社区 创建 的 模板 引擎 ; 
口 用 扩展 Express 的 模块 提升 你 的 程序 。 


C.1.1 注册 模板 引擎 


引擎 可 能 会 通过 输出 一 个 express 方 法 提供 开 箱 即 用 的 Express 文 持 。 但 并 不 是 每 个 引擎 
都 有 这 个 , 或 者 你 可 能 想 写 自 己 的 引擎 。Express 为 此 提供 了 app .engine () 方 法 作为 这 种 功能 实 
现 的 支持 。 本 节 会 写 一 个 小 型 的 markdown 模 板 引 擎 ， 并 且 可 以 用 变量 替换 动态 内 容 。 

app .engine() 方 法 将 文件 扩展 名 对 应 到 回调 孔 数 上 ,以便 Express 知 道 如 何 使 用 它 。 在 下 面 
的 代码 清单 中 传 入 的 是 扩展 名 .md, 这 样 res .render ('myview.md') 之 类 的 演 染 调用 会 用 这 个 
回调 孔 数 演 染 文件 。 这 种 抽象 让 任何 模板 引 敬 都 可 以 用 在 框架 内 。 在 这 个 定制 的 模板 引擎 中 ， 可 
以 用 大 括号 括 起 来 的 局 部 变量 使 用 动态 输入 一 一 比如 说 , 不管 在 模板 中 的 哪个 位 置 出 现 , {name} 
会 输出 name 的 值 。 


代码 清单 C-1 处 理 扩展 名 .md 


Var express = require('express'); 























Var http = require('http'); 


Var md = require('github-flavored-markdown') .parse; 
Var Fe SS Ledquiret fery; 引入 一 个 markdown 实 现 
Var app = express ( ) ; 
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appD .enoine(l'md', function(path, optlions, fny7 < 一 将 这 个 回调 函数 对 应 到 .md 文件 上 
fs.readrFile(path, 'utf8', function(err, str){ <— 读 取 文 件 中 的 内 容 , 作为 字符 串 变 量 


if (err) return fnl(err); < 一 将 错误 转 给 Express 
Cry 
Yar henl. = ma(str), < 一 将 markdown 字 符 串 转换 成 HTML 
html EE html.replace(/N{([^}+]+)\}/g, function(., name)t! 
口 夫 
return options [name] || 执行 大 振 号 营 换 
默认 值 为 " js 
〈 空 字符 串 ) 人 < 一 将 泻 染 好 的 HTML 传 给 Express 


} catch (err) { 
fn (err); < 一 捕获 所 有 抛 出 来 的 错误 
} 
}); 
由 


代码 清单 C-1 中 的 模板 引擎 可 以 用 来 编写 包含 动态 内 容 的 markdown 视 图 。 比 如 说 ， 如 果 你 想 
用 markdown 跟 用 户 问 好 ， 代 码 看 起 来 可 能 是 这 样 的 : 


# {name} 
Greetings {name}! Nice to have you check out our application {appName}. 








C.1.2 ”consolidate.js 模 板 


consolidate.js 项 目 是 专 为 Express 3.x 定 制 的 ， 并 且 它 为 很 多 Node 模 板 引 苟 提 供 了 一 个 统一 
API。 也 就 是 说 在 Express 3.x 中 可 以 直接 使 用 的 模板 引擎 超过 14 和 种， 或 者 如 采 你 正在 重 构 使 用 模 
板 的 库 ， 可 以 利用 consolidate.js 提 供 的 广泛 模板 选择 。 
比如 受到 Django 启 发 的 模板 引擎 Swig。 它 用 棱 在 HTML 中 的 标签 定义 欣 辑 ， 比 如 像 这 样 : 
<ul> 
%$ for Pet in pets %} 
<1i>{{ pet.name }}</11i> 


当 endfor %} 
</ul> 


取决 于 模板 引擎 和 编辑 器 的 语法 高 亮 文 持 ， 你 可 能 想 让 HTML 风格 的 引擎 使 用 .html 作 模板 
的 扩展 名 ， 而 不 是 使 用 引擎 的 名 称 ， 比如 . SW1igo 你 可 以 用 Express app.engine() 达成 这 一 
目标 。 一 旦 被 调用 ，Express 泻 染 .html 文 件 时 ， 就 会 用 Swig: 




















Var cons = require('consolidate'); 

app.engine('html', cons.swig); 

EJS 模 板 引 擎 很 可 能 也 会 被 对 应 到 .htmL 上 ， 因 为 它 也 是 用 的 能 入 标签 : 
<ul> 


<%$ pets.forEach (function(pet){ 和 > 
<11i><%= pet.name %></11i> 
<%S }) %$> 
</ul> 
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有 些 模 板 引 区 用 的 是 完全 不 同 的 语法 ， 因 此 让 它们 跟 .html 对 应 也 没什么 音义 。Jade 就 是 这 样 
的 典型 ， 它 有 上 自己 的 声明 式 语言 。Jade 可 能 会 用 下 面 这 些 调用 做 对 应 : 


Var cons = require('consolidate'); 
app.engine('Jade', cons.Jade); 


要 了 解 细节 , 以 及 所 支持 的 模板 引擎 的 清单 , 请 访问 consolidate.js 项 目的 GitHub 库 https://github. 


com/visionmedia/consolidate.]s。 





C.1.3 Express 的 扩展 及 框架 


你 可 能 想 知 道 ， 那 些 所 用 的 框 染 结构 化 程度 更 高 ( 比如 RoR ) 的 开发 人 员 有 哪些 选择 。 对 于 
那些 状况 ，Express 有 几 个 选择 。Express 社 区 已 经 以 Express 为 基础 开发 出 了 几 个 更 高 层 的 框架 ， 
提供 目录 结构 ， 以 及 高 层 的 、 有 人 针对 性 的 功能 ， 比 如 Rails 风 格 的 控制 疾 。 除 了 这 些 框架 ,Express 
还 做 了 各 种 插件 来 扩展 它 的 功能 。 

1. EXPRESS-EXPOSE 

用 express-expose 插 件 可 以 把 服务 大 端的 JavaScript 对 象 导 到 客户 闪 。 比 如 说 ， 如 采 你 想 将 已 
认证 用 户 对 象 的 JSON 表 示 形 式 导 出 去 ， 可 以 调用 res .expose()， 把 express .user 对 象 给 你 
的 客户 问 代 人 码 : 

res.expose(redq.user, 'express.user'); 

2. EXPRESS-RESOURCE 

express-resource 也 是 一 个 优秀 的 插件 ， 用 来 对 路 由 做 结构 化 处 理 的 、 资 源 丰 定 的 路 由 插件 。 

路 由 有 很 多 种 做 法 , 但 Express 默 认 提 供 的 归根 结 底 只 是 请 求 方法 和 路 径 。 但 可 以 在 其 上 构建 
更 高 层 的 概念 。 

在 下 面 这 个 例子 中 , 用 声明 式 的 风格 定义 了 展示 、 创 建 和 更 新 用 户 资源 的 动作 。 首 先 把 这 个 
加 到 app.js 中 : 

app.resource('user', require('./controllers/user')); 


下 面 是 控制 如 模块 ./controllers/user.js 的 样子 。 
代码 清单 C-2 ”userjs 资 源 文 件 
exports.new = function(req, res)t 


res.send('new user').， 


} 




















exports.create = functionl(req, res)t 
res.send('create user'); 


} > 
exports.show = function(req, res)t 


res.send('show user ' + reqgq.params .user); 


上 
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要 查看 完整 的 插件 、 模 板 引 擎 和 框架 的 列表 ， 请 访问 Express 的 wiki: https://github.com/ 


vislonmedia/express/Wwik1。 


C.2 高 级 配置 


前 面 有 一 章 介 绍 了 如 何 用 app .configure() 配 置 Express， 并 讨论 了 几 个 配置 选项 。 本 节 会 
出 介 绍 一 些 配置 项 ， 告诉 你 如 何 改 变 Express 的 默认 行为 ， 并 释放 更 多 功能 。 
表 C-1 列 出 了 我 们 在 第 8 曹 讨论 过 的 Express 配 置 项 。 


表 C-1 内 置 的 Express 设 定 





default engine 所 用 的 默认 模板 引 区 

Views 视图 奋 找 路 径 

json replacer 响应 JSON 操 作 轴 数 

json spaces 用 来 对 JSON 员 应 格式 化 的 空格 数量 

jsonp callback 支持 带 res .json() 和 res .send() 的 JSONP 
trust proxy 信任 反问 代理 

View cache 缓存 模板 引擎 函 数 





配置 项 views 特 别 简 单 直接 ， 用 来 指定 视图 模板 放 哪 。 当 你 在 命令 行 中 用 express 命 令 创 建 
程序 骨架 时 ， 配 置 项 views 目 动 设 定 为 程序 的 视图 子 目录 。 
接 下 来 我 们 看 一 个 更 复杂 的 配置 项 : json_replacer。 








C.2.1 操作 JSON 听 应 


假定 有 个 user 对 象 ,有 一 些 私 有 属性 , 比如 说 对 象 的 _idq。 默 认 情 况 下 ,调用 res .send (user) 
方法 会 给 出 类 似 于 {1" idq":123，"name" :Tobi"} 这 样 的 ON。 配 置 项 json replacer 会 计 
Express 在 调用 res .senda() 和 tres.json() 的 过 程 中 传 给 JsoN.stringify() 一 个 因数 。 

下 面 代码 清单 中 这 个 独立 的 Express 程 序 ， 曾 明了 如 何 用 这 个 函数 在 JSON 啊 应 中 忽略 以 " 
开头 的 属性 。 这 个 例子 中 的 啊 应 将 变 成 {"name" :"Tobi"}。 


代码 清单 C-3 用 json replacer 控 制 及 修改 JSON 数 据 











Var express = require('express'); 

Var app = express(); 

app.set('json replacer', function(key, value)t 
if ('_' == key[0]) return; 


return value; 


}); 
Var user = { _id: 123, name: 'Tobi' }; 


app.get('/user', function(req, res)t 
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res.send (user): 


}); 


app.listen(3000); 

注意 ， 对 和 象 及 其 原型 可 以 实现 .toJSON() 方 法 。JSON .stringify () 在 将 对 和 象 转换 成 JSON 
字符 串 时 使 用 这 个 方法 。 如 果 你 的 处 理 并 不 是 适用 于 每 个 对 象 ， 可 以 用 这 种 方式 代替 json 
replacer 回 调 。 

现在 你 已 经 知道 在 JSON 输 出 过 程 中 如 何 控制 导出 的 数据 了 ， 接 下 来 我 们 看 看 如 何 微调 JSON 
数据 的 格式 。 











C.2.2 JSON 响 应 格式 


配置 项 json spaces 会 影响 Express 中 的 JSON .stringify() 调 用 。 这 个 设 定 表 明 在 将 JSON 
格式 化 为 字符 串 时 用 多 少 空格 。 

这 个 方面 默认 会 返回 经 过 压缩 的 JSON ， 比 如 {"name":"Tobi" "age":2,"species'" : 
"ferret"}。 上 压缩 过 的 JSON 非 常 适合 用 在 生产 环境 中 ， 因 为 它 可 以 降低 响应 的 大 小 。 但 在 开发 
时 ， 未 压缩 的 输出 可 谈 性 更 强 。 

配置 项 json spaces 在 生产 环境 中 会 目 动 设 为 0。 在 开发 环境 中 设 为 2， 会 产生 下 面 这 种 输出 : 

{ 








"name": "Tobi", 
"age": 2， 
"species": "ferret" 


} 


C.2.3 ”信任 反问 代理 头 域 


默认 情况 下 , Express 内 部 在 任何 环境 中 都 不 会 信任 反 向 代理 头 域 。 反 向 代理 超出 了 本 书 的 讨 
论 范 玮 ， 但 如 果 你 的 程序 运行 在 反 回 代理 后 面 ， 比 如 Nginx、HAProxy 或 Varnish， 你 就 需要 局 用 
trust proxy, 这 样 Express 才 知道 查询 这 些 域 是 安全 的 。 
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翻译 日 文书 或 文章 : @ 图 灵 乐 馨 
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Node.js in Action 服务 器 端 JavaScript? 没 错 。Node.js 是 一 
国 上 加 个 JavaScript 服 务 器 ， 支 持 可 伸缩 的 高 性 能 
INIAN @ Ci I Web 应 用 。 借 助 异步 /O ， 这 个 服务 器 可 以 同 
A 和 AIL 4d 时 做 很 多 事情 ， 能 满足 聊天 、 游 戏 和 实时 统计 
: 等 应 用 的 需求 。 并 且 既 然 是 JavaScript， 那 你 
就 可 以 全 栈 使 用 一 种 语言 。 





本 书 向 读者 展示 了 如 何 构建 产品 级 应 用 ， 
对 关键 概念 的 介绍 清晰 明了 ， 贴 近 实 际 的 例 
子 ， 酒 盖 从 安装 到 部 署 的 各 个 环节 ， 是 一 部 讲 
解 与 实践 并 重 的 优秀 著作 。 通 过 学 习 本 书 ， 读 

“这 本 书 由 众 位 大 神 写 来 ,驾轻就熟 地 告诉 者 将 深入 异步 编程 、 数 据 存 储 、 输 出 模板 、 读 
大 家 Node 应 用 该 如 何 编 写 。 从 侧面 也 能 看 出 写 文件 系统 ， 掌 握 创 建 TCP/IP 服 务 器 和 命令 行 
么 轻 量 级 的 平台 。 期 望 你 看 完 之 工具 等 非 HTTP 程 序 的 技术 。 本 书 同样 非常 适 

也 能 驾轻就熟 地 编写 属于 自己 的 Node 应 用 。 合 熟悉 Rails、Django 或 PHP 开 发 的 读者 阅读 


一 朴 灵 J 
Node.js 布 道 者 、《 深 入 浅 出 Node.js》 作 者 





“一 本 由 浅 入 深 、 循 序 渐进 的 佳作 。” 本 书 主要 内 容 : 
一 一 Isaac Z. Schlueter @Node.js 及 其 扩展 的 安 狐 配置 
Node.js 项 目 负责 人 、Node 包 管理 器 ( NPM ) 作者 @ 全 面 理 解 异步 编程 和 事件 循环 


全 学 会 开发 微 博 、 聊 天 和 游戏 等 热门 应 用 


局 则 MANNING 


ts iTuring.cn | 
热线 : ee 917871151013524601> 


分 类 建议 计算机/ Nodejs ISBN 978-7-115-35246-0 
人 民 邮 电 出 版 社 网 址 ; WWW. ee com.cn 








定价 : 69.00 元 
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欢迎 加 入 


到 灵 社区 


电子 书 发 售 乎 合 


电子 出 版 的 时 代 已 经 来 临 ， 在 许多 出 版 界 同行 还 在 犹 耳 往 得 的 时 候 ， 图 灵 社 区 已 经 
采取 实际 行动 拥抱 这 个 出 版 业 巨 变 。 相 比 纸 质 书 ， 电 子 书 具 有 许多 明显 的 优势 。 已 
不 仅 发 布 快 ， 更 新 容易 ， 而 且 尽 可 能 采用 了 彩色 图 片 (即使 有 的 书 纸 质 版 是 黑 日 印 
刷 的 ) 。 读 者 还 可 以 方便 地 进行 搜索 、 和 剪贴 、 复 制 和 打 。 


图 灵 社 区 进一步 把 传统 出 版 流程 与 电子 出 版 业务 紧密 结合 ， 目 前 已 实现 作 译 者 网 上 
交 稿 、 编 辑 网 上 审 稿 、 按 章 发 布 的 电子 出 版 模式 。 这 种 新 的 出 版 模式 ， 我 们 称 之 为 
敏捷 出 版 ”， 叱 可 以 让 读者 以 较 快 的 速度 了 解 到 国外 最 新 扩 术 图 书 的 内 容 ， 吹 补 
以 往 翻译 版 技术 书 “ 出 版 即 过 时 ”的 缺憾 。 同 时 ， 敏 捷 出 版 使 得 作 、 译 、 编 、 读 的 
交流 更 为 方便 ， 可 以 提前 消灭 书稿 中 的 销 误 ， 最 大 程度 地 保证 图 书 出 版 的 质量 。 


开放 出 版 平台 


图 灵 社 区 同 读 者 开放 在 线 写 作 功 能 ， 协 助 你 实现 目 出 版 的 梦想 。 你 可 以 联合 二 三 好 
友 共 同 创作 一 部 扩 术 参考 书 ， 以 免费 或 收费 的 形式 提供 给 读者 ， 这 极 大 地 降低 了 出 
版 的 门槛 。 成 熟 的 书稿 ， 有 机 会 入选 出 版 计划 ， 同 时 出 版 纸 质 书 。 


图 灵 社 区 引进 出 版 的 外 文 图 书 ， 痢 将 在 立项 后 马上 在 社区 公布 。 如 果 有 蕊 翻译 哪 本 
图 书 ， 欢 迎 来 社区 申请 。 只 要 通过 试 译 的 考验 ， 即 可 侈 约 成 力图 灵 的 译 者 。 当 然 ， 
要 想 成 功 地 完成 一 本 书 的 翻译 工作 ， 是 需要 有 坚强 的 妆 力 的 。 


读者 交 帝 平 合 

在 图 灵 人 社区 ， 读 者 可 以 十 分 方便 地 写作 文章 、 提 交 勘 误 、 发 表 评 论 ， 以 各 种 万 式 与 
作 译 者 、 编 辑 人 员 和 其 他 读者 进行 交流 互动 。 提 交 勘 误 还 能 够 获 赠 社区 银子 。 欢 迎 
大 家 积极 参与 社区 开展 的 访谈 、 审 谈 、 评 选 等 多 种 活动 ， 赢 取 银 子 ， 可 以 换 书 哦 
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